NhpAllocateAndGetInterfaceInfoFromStack, fonction (iphlpapi.h)

Article
03/04/2024

[Cette fonction n’est plus disponible à partir de Windows Vista. Utilisez plutôt la fonction GetAdaptersAddresses et la structure IP_ADAPTER_ADDRESSES associée.]

La fonction NhpAllocateAndGetInterfaceInfoFromStack obtient des informations sur l’adaptateur sur l’ordinateur local.

Syntaxe

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

Paramètres

ppTable

Tableau de structures IP_INTERFACE_NAME_INFO qui contient des informations sur chaque adaptateur sur le système local. Le tableau contient un élément pour chaque carte sur le système.

pdwCount

Nombre d’éléments dans le tableau ppTable .

bOrder

Lorsque la valeur EST TRUE, les éléments du tableau ppTable sont triés en augmentant la valeur de l’index.

hHeap

Handle qui spécifie le tas à partir duquel ppTable doit être alloué. Ce paramètre peut être le tas de processus retourné par un appel à la fonction GetProcessHeap ou un tas privé créé par un appel à la fonction HeapCreate .

dwFlags

Ensemble d’indicateurs à passer à la fonction HeapAlloc lors de l’allocation de mémoire pour ppTable. Pour plus d’informations, consultez la fonction HeapAlloc .

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite de l’exécution.

Remarques

Dans microsoft Kit de développement logiciel Windows (Kit SDK Windows) (SDK), la fonction NhpAllocateAndGetInterfaceInfoFromStack est définie sur Windows 2000 avec Service Pack 1 (SP1) et versions ultérieures. Lors de la compilation d’une application, si la plateforme cible est Windows 2000 avec SP1 et versions ultérieures (NTDDI_VERSION >= NTDDI_WIN2KSP1, _WIN32_WINNT >= 0x0500ou WINVER >= 0x0500), le NhpAllocateAndGetInterfaceInfoFromStack est défini.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	iphlpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll