Funzione NhpAllocateAndGetInterfaceInfoFromStack (iphlpapi.h)

Articolo
02/28/2024

[Questa funzione non è più disponibile per l'uso a partire da Windows Vista. Usare invece la funzione GetAdaptersAddresses e la struttura IP_ADAPTER_ADDRESSES associata.

La funzione NhpAllocateAndGetInterfaceInfoFromStack ottiene informazioni sull'adattatore sul computer locale.

Sintassi

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

Parametri

ppTable

Matrice di strutture IP_INTERFACE_NAME_INFO che contiene informazioni su ogni scheda nel sistema locale. La matrice contiene un elemento per ogni adapter nel sistema.

pdwCount

Numero di elementi nella matrice ppTable .

bOrder

Quando TRUE, gli elementi nella matrice ppTable vengono ordinati aumentando il valore dell'indice.

hHeap

Handle che specifica l'heap da cui deve essere allocato ppTable . Questo parametro può essere l'heap del processo restituito da una chiamata alla funzione GetProcessHeap o un heap privato creato da una chiamata alla funzione HeapCreate .

dwFlags

Set di flag da passare alla funzione HeapAlloc durante l'allocazione della memoria per ppTable. Per altre informazioni, vedere la funzione HeapAlloc .

Valore restituito

Restituisce ERROR_SUCCESS al completamento corretto.

Commenti

Nella funzione Microsoft Windows Software Development Kit (Windows SDK) (SDK), la funzione NhpAllocateAndGetInterfaceInfoFromStack è definita in Windows 2000 con Service Pack 1 (SP1) e versioni successive. Quando si compila un'applicazione, se la piattaforma di destinazione è Windows 2000 con SP1 e versioni successive (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500o WINVER >= 0x0500), viene definito nhpAllocateAndGetInterfaceInfoFromStack .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2003, Windows 2000 Server con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll