fonction if_nametoindex
La fonction if_nametoindex convertit le nom de l’interface ANSI d’une interface réseau en index local de l’interface.
Syntaxe
NET_IFINDEX NETIOAPI_API_ if_nametoindex(
_In_ PCSTR InterfaceName
);
Paramètres
-
InterfaceName [in]
Pointeur vers une chaîne ANSI terminée par NULL qui contient le nom de l’interface.
Valeur de retour
Si la fonction réussit, if_nametoindex retourne l’index de l’interface locale. Si la fonction échoue, if_nametoindex retourne zéro.
Remarques
La fonction if_nametoindex mappe un nom d’interface dans son index correspondant. Cette fonction est conçue dans le cadre des extensions de socket de base pour IPv6, comme décrit par l’IETF dans RFC 2553.
La fonction if_nametoindex est implémentée pour la portabilité des pilotes avec des environnements Unix, mais les fonctions ConvertInterfaceXxx sont la méthode préférée pour convertir les identificateurs d’interface réseau. Vous pouvez remplacer la fonction if_nametoindex par un appel à la fonction ConvertInterfaceNameToLuidA pour convertir le nom de l’interface ANSI en union NET_LUID, suivi d’un appel à la fonction ConvertInterfaceLuidToIndex pour convertir NET_LUID en index d’interface locale.
Si la fonction if_nametoindex échoue et retourne zéro, vous ne pouvez pas déterminer un code d’erreur.