GetUdpTable

The GetUdpTable function retrieves the User Datagram Protocol (UDP) listener table.

DWORD GetUdpTable(
  PMIB_UDPTABLE pUdpTable,  // buffer for the listener table 
  PDWORD pdwSize,           // size of buffer
  BOOL bOrder               // sort the table?
);

Parameters

pUdpTable
[out] Pointer to a buffer that receives the UDP listener table as a MIB_UDPTABLE structure.
pdwSize
[in, out] On input, specifies the size of the buffer pointed to by the pUdpTable parameter.

On output, if the buffer is not large enough to hold the returned listener table, the function sets this parameter equal to the required buffer size.

bOrder
[in] Specifies whether the returned table should be sorted. If this parameter is TRUE, the table is sorted in the order of:
  1. IP address
  2. Port

Return Values

If the function succeeds, the return value is NO_ERROR.

If the function fails, use FormatMessage to obtain the message string for the returned error.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP4 or later.
  Windows 95/98: Requires Windows 98.
  Header: Declared in Iphlpapi.h.
  Library: Use Iphlpapi.lib.

See Also

MIB_UDPTABLE