NhpAllocateAndGetInterfaceInfoFromStack-Funktion (iphlpapi.h)
[Diese Funktion steht ab Windows Vista nicht mehr zur Verfügung. Verwenden Sie stattdessen die GetAdaptersAddresses-Funktion und die zugeordneteIP_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 |