NhpAllocateAndGetInterfaceInfoFromStack 函式 (iphlpapi.h)

發行項
02/28/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 軟體開發套件 (SDK) 中，NhpAllocateAndGetInterfaceInfoFromStack 函式定義在 Windows 2000 上，Service Pack 1 (SP1) 和更新版本。編譯應用程式時，如果目標平臺是具有SP1和更新版本的Windows 2000 (、或) ，則會定義 NhpAllocateAndGetInterfaceInfoFromStack。WINVER >= 0x0500_WIN32_WINNT >= 0x0500NTDDI_VERSION >= NTDDI_WIN2KSP1

規格需求

需求	值
最低支援的用戶端	Windows XP，Windows 2000 專業版 SP1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003、具有 SP1 的 Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	iphlpapi.h
程式庫	Iphlpapi.lib
Dll	Iphlpapi.dll