NhpAllocateAndGetInterfaceInfoFromStack-Funktion (iphlpapi.h)

Artikel
08/24/2023

[Diese Funktion steht ab Windows Vista nicht mehr zur Verfügung. Verwenden Sie stattdessen die GetAdaptersAddresses-Funktion und die zugeordnete IP_ADAPTER_ADDRESSES-Struktur .]

Die NhpAllocateAndGetInterfaceInfoFromStack-Funktion ruft Adapterinformationen zum lokalen Computer ab.

Syntax

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

Parameter

ppTable

Ein Array von IP_INTERFACE_NAME_INFO Strukturen, das Informationen zu den einzelnen Adaptern im lokalen System enthält. Das Array enthält ein Element für jeden Adapter im System.

pdwCount

Die Anzahl der Elemente im ppTable-Array .

bOrder

Bei TRUE werden Elemente im ppTable-Array sortiert, indem der Indexwert erhöht wird.

hHeap

Ein Handle, das den Heap angibt, aus dem ppTable zugeordnet werden soll. Dieser Parameter kann der Prozessheap sein, der von einem Aufruf der GetProcessHeap-Funktion zurückgegeben wird, oder ein privater Heap, der durch einen Aufruf der HeapCreate-Funktion erstellt wird.

dwFlags

Eine Reihe von Flags, die bei der Zuweisung von Arbeitsspeicher für ppTable an die Funktion HeapAlloc übergeben werden sollen. Weitere Informationen finden Sie in der HeapAlloc-Funktion .

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück.

Hinweise

Im Microsoft Windows Software Development Kit (SDK) ist die NhpAllocateAndGetInterfaceInfoFromStack-Funktion unter Windows 2000 mit Service Pack 1 (SP1) und höher definiert. Wenn die Zielplattform windows 2000 mit SP1 und höher (NTDDI_VERSION >= NTDDI_WIN2KSP1, oderWINVER >= 0x0500) ist, _WIN32_WINNT >= 0x0500wird beim Kompilieren einer Anwendung der NhpAllocateAndGetInterfaceInfoFromStack definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll