NhpAllocateAndGetInterfaceInfoFromStack 函数 (iphlpapi.h)

项目
03/13/2024

[此函数在 Windows Vista 中不再可用。请改用 GetAdaptersAddresses 函数和关联的 IP_ADAPTER_ADDRESSES 结构。]

NhpAllocateAndGetInterfaceInfoFromStack 函数获取有关本地计算机的适配器信息。

语法

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

参数

ppTable

包含有关本地系统上每个适配器的信息的IP_INTERFACE_NAME_INFO 结构的数组。数组包含系统上每个适配器的一个元素。

pdwCount

ppTable 数组中的元素数。

bOrder

如果 为 TRUE， 则 ppTable 数组中的元素按增加索引值进行排序。

hHeap

一个句柄，指定应从中分配 ppTable 的堆。此参数可以是调用 GetProcessHeap 函数返回的进程堆，也可以是调用 HeapCreate 函数创建的专用堆。

dwFlags

为 ppTable 分配内存时要传递给 HeapAlloc 函数的一组标志。有关详细信息，请参阅 HeapAlloc 函数。

返回值

成功完成后返回ERROR_SUCCESS。

注解

在 Microsoft Windows 软件开发工具包 (Windows SDK) (SDK) 中，在 Windows 2000 上定义了 NhpAllocateAndGetInterfaceInfoFromStack 函数，其中包含 Service Pack 1 (SP1) 及更高版本。编译应用程序时，如果目标平台是具有 SP1 的 Windows 2000 和更高版本 (NTDDI_VERSION >= NTDDI_WIN2KSP1、 _WIN32_WINNT >= 0x0500或 WINVER >= 0x0500) ，则会定义 NhpAllocateAndGetInterfaceInfoFromStack 。

要求

要求	值
最低受支持的客户端	具有 SP1 的 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows Server 2003、Windows 2000 Server SP1 [仅限桌面应用]
目标平台	Windows
标头	iphlpapi.h
Library	Iphlpapi.lib
DLL	Iphlpapi.dll