ConvertInterfaceLuidToIndex, fonction (netioapi.h)

Article
03/04/2024

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

Syntaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToIndex(
  [in]  const NET_LUID *InterfaceLuid,
  [out] PNET_IFINDEX   InterfaceIndex
);

Paramètres

[in] InterfaceLuid

Pointeur vers un NET_LUID pour une interface réseau.

[out] InterfaceIndex

Valeur d’index local pour l’interface.

Valeur retournée

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

Code d'erreur	Signification
ERROR_INVALID_PARAMETER	L'un des paramètres n'était pas valide. Cette erreur est retournée si le paramètre InterfaceLuid ou InterfaceIndex était NULL ou si le paramètre InterfaceLuid n’était pas valide.

Remarques

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

La fonction ConvertInterfaceLuidToIndex 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