GetAdapterIndex, fonction (iphlpapi.h)

Article
02/28/2024

La fonction GetAdapterIndex obtient l’index d’un adaptateur, en fonction de son nom.

Syntaxe

IPHLPAPI_DLL_LINKAGE DWORD GetAdapterIndex(
  [in]      LPWSTR AdapterName,
  [in, out] PULONG IfIndex
);

Paramètres

[in] AdapterName

Pointeur vers une chaîne Unicode qui spécifie le nom de l’adaptateur.

[in, out] IfIndex

Pointeur vers une variable ULONG qui pointe vers l’index de l’adaptateur.

Valeur retournée

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

Si la fonction échoue, utilisez FormatMessage pour obtenir la chaîne de message de l’erreur retournée.

Remarques

Jusqu’à ce qu’un adaptateur soit complètement désactivé, la fonction GetAdapterIndex signale l’adaptateur comme étant présent. Par exemple, la fonction NotifyAddrChange peut indiquer que l’adresse IP d’un adaptateur récemment désactivé est supprimée, mais GetAdapterIndex continue à signaler un index d’adaptateur jusqu’à ce que le processus de désactivation de l’adaptateur soit terminé.

Lorsqu’un ou plusieurs adaptateurs sont présents sur le système, GetAdapterIndex retourne ERROR_DEV_NOT_EXIST lorsque l’adaptateur interrogé n’existe pas. Lorsqu’aucun adaptateur n’est présent, la fonction GetAdapterIndex retourne ERROR_NO_DATA.

L’index de l’adaptateur peut changer lorsqu’un 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 uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	iphlpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll