if_nametoindex fonction

La fonction if_nametoindex convertit le nom d’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 retournée

Si la fonction réussit, if_nametoindex retourne l’index d’interface locale. Si la fonction échoue, if_nametoindex retourne zéro.

Notes

La fonction if_nametoindex mappe un nom d’interface à 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.

Spécifications

Voir aussi

ConvertInterfaceLuidToIndex

ConvertInterfaceNameToLuidA

NET_LUID