GetPerAdapterInfo, fonction (iphlpapi.h)

Article
02/28/2024

La fonction GetPerAdapterInfo récupère des informations sur l’adaptateur correspondant à l’interface spécifiée.

Syntaxe

IPHLPAPI_DLL_LINKAGE DWORD GetPerAdapterInfo(
  [in]  ULONG                IfIndex,
  [out] PIP_PER_ADAPTER_INFO pPerAdapterInfo,
  [in]  PULONG               pOutBufLen
);

Paramètres

[in] IfIndex

Index d’une interface. La fonction GetPerAdapterInfo récupère les informations de l’adaptateur correspondant à cette interface.

[out] pPerAdapterInfo

Pointeur vers une structure IP_PER_ADAPTER_INFO qui reçoit des informations sur l’adaptateur.

[in] pOutBufLen

Pointeur vers une variable ULONG qui spécifie la taille de la structure IP_PER_ADAPTER_INFO . Si cette taille est insuffisante pour contenir les informations, GetPerAdapterInfo remplit cette variable avec la taille requise et retourne un code d’erreur de ERROR_BUFFER_OVERFLOW.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_BUFFER_OVERFLOW	La taille de la mémoire tampon indiquée par le paramètre pOutBufLen est trop petite pour contenir les informations de l’adaptateur. Le paramètre pOutBufLen pointe vers la taille requise.
ERROR_INVALID_PARAMETER	Le paramètre pOutBufLen est NULL, ou le processus appelant n’a pas d’accès en lecture/écriture à la mémoire pointée par pOutBufLen, ou le processus appelant n’a pas d’accès en écriture à la mémoire pointée par le paramètre pAdapterInfo .
ERROR_NOT_SUPPORTED	GetPerAdapterInfo n’est pas pris en charge par le système d’exploitation exécuté sur l’ordinateur local.
Autres	Si la fonction échoue, utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

Un index d’adaptateur peut changer lorsque l’adaptateur est désactivé, puis activé, ou dans d’autres circonstances, et ne doit pas être considéré comme persistant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	iphlpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll

Voir aussi

Informations de référence sur les fonctions d’assistance IP

Page de démarrage de l’assistance IP

IP_PER_ADAPTER_INFO

Partager via