NhpAllocateAndGetInterfaceInfoFromStack function

[This function is no longer available for use as of Windows Vista. Instead, use the GetAdaptersAddresses function and the associated IP_ADAPTER_ADDRESSES structure.]

The NhpAllocateAndGetInterfaceInfoFromStack function obtains adapter information about the local computer.

Syntax

DWORD NhpAllocateAndGetInterfaceInfoFromStack(
   IP_INTERFACE_NAME_INFO ppTable,
   PDWORD                 pdwCount,
   BOOL                   bOrder,
   HANDLE                 hHeap,
   DWORD                  dwFlags
);

Parameters

ppTable

An array of IP_INTERFACE_NAME_INFO structures that contains information about each adapter on the local system. The array contains one element for each adapter on the system.

pdwCount

The number of elements in the ppTable array.

bOrder

When TRUE, elements in the ppTable array are sorted by increasing index value.

hHeap

A handle that specifies the heap from which ppTable should be allocated. This parameter can be the process heap returned by a call to the GetProcessHeap function, or a private heap created by a call to the HeapCreate function.

dwFlags

A set of flags to be passed to the HeapAlloc function when allocating memory for ppTable. See the HeapAlloc function for more information.

Return value

Returns ERROR_SUCCESS upon successful completion.

Remarks

In the Microsoft Windows Software Development Kit (SDK), the NhpAllocateAndGetInterfaceInfoFromStack function is defined on Windows 2000 with Service Pack 1 (SP1) and later. When compiling an application, if the target platform is Windows 2000 with SP1 and later (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500, or WINVER >= 0x0500), the NhpAllocateAndGetInterfaceInfoFromStack is defined.

Requirements

See also

IP Helper Start Page

IP Helper Function Reference

GetAdaptersAddresses

GetProcessHeap

HeapCreate

IP_INTERFACE_NAME_INFO