AllocateAndGetUdpExTableFromStack function (iphlpapi.h)

[This function is no longer available for use as of Windows Vista. Instead, use the GetUdpTable or GetExtendedUdpTable function to retrieve the UDP connection table.]

The AllocateAndGetUdpExTableFromStack function retrieves the UDP connection table and allocates memory from the local heap to store the table.

Syntax

DWORD AllocateAndGetUdpExTableFromStack(
  [out] PVOID  *ppUdpTable,
  [in]  BOOL   bOrder,
  [in]  HANDLE hHeap,
  [in]  DWORD  dwFlags,
  [in]  DWORD  dwFamily
);

Parameters

[out] ppUdpTable

Pointer to the address of the opaque data that contains the UDP connection table after the function returns.

[in] bOrder

If true, the UDP connection entries in the table returned in ppUDPTable are sorted; if false, they are not.

[in] hHeap

Handle to the heap from which the memory to store the table will be allocated.

[in] dwFlags

One or more flags that indicate specific heap allocation control behaviors.

[in] dwFamily

The family of the UDP addresses in the table.

Value Meaning
AF_INET
Retrieve IPv4 UDP addresses.
AF_INET6
Retrieve IPv6 UDP addresses.

Return value

If the function succeeds, it returns ERROR_SUCCESS.

If the function fails, it returns a function from winerror.h.

Remarks

In the Microsoft Windows Software Development Kit (SDK) released for Windows Vista and later, the function prototype for AllocateAndGetUdpExTableFromStack is still defined in the Iphlpapi.h header file for continued support on Windows Server 2003 and Windows XP.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header iphlpapi.h
Library Iphlpapi.lib
DLL Iphlpapi.dll

See also

AllocateAndGetTcpExTableFromStack

GetExtendedUdpTable

GetUdpTable