Fonction ConvertInterfaceIndexToLuid (netioapi.h)

Article
03/04/2024

La fonction ConvertInterfaceIndexToLuid convertit un index local pour une interface réseau en identificateur unique local (LUID) de l’interface.

Syntaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PNET_LUID   InterfaceLuid
);

Paramètres

[in] InterfaceIndex

Valeur d’index local pour une interface réseau.

[out] InterfaceLuid

Pointeur vers le NET_LUID pour cette interface.

Valeur retournée

En cas de réussite, ConvertInterfaceIndexToLuid retourne NO_ERROR. Toute valeur de retour différente de zéro indique un échec et une valeur NULL est retournée dans le paramètre InterfaceLuid .

Code d'erreur	Signification
ERROR_FILE_NOT_FOUND	Le système ne peut pas trouver le fichier spécifié. Cette erreur est retournée si l’interface réseau spécifiée par le paramètre InterfaceIndex n’était pas une valeur sur l’ordinateur local.
ERROR_INVALID_PARAMETER	L'un des paramètres n'était pas valide. Cette erreur est retournée si le paramètre InterfaceLuid était NULL ou si le paramètre InterfaceIndex n’était pas valide.

Remarques

La fonction ConvertInterfaceIndexToLuid est disponible sur Windows Vista et versions ultérieures.

La fonction ConvertInterfaceIndexToLuid est indépendante du protocole et fonctionne avec les interfaces réseau pour les protocoles IPv6 et IPv4.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	netioapi.h (include Iphlpapi.h)
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll