Partager via


if_indextoname fonction

La fonction if_indextoname convertit l’index local d’une interface réseau en nom d’interface ANSI.

Syntaxe

PCHAR NETIOAPI_API_ if_indextoname(
  _In_  NET_IFINDEX InterfaceIndex,
  _Out_ PCHAR       InterfaceName
);

Paramètres

  • InterfaceIndex [in]
    Index local d’une interface réseau.

  • InterfaceName [out]
    Pointeur vers une mémoire tampon pour contenir la chaîne ANSI terminée par NULL. Si if_indextoname réussit, InterfaceName contient le nom de l’interface ANSI. La longueur, en octets, de la mémoire tampon vers laquelle ce paramètre pointe doit être égale ou supérieure à IF_NAMESIZE. Pour plus d’informations sur IF_NAMESIZE, consultez la section Remarques suivante.

Valeur retournée

Si cette fonction réussit, if_indextoname retourne un pointeur vers une chaîne ANSI terminée par NULL qui contient le nom de l’interface. Si cette fonction échoue, if_indextoname retourne un pointeur NULL

Notes

La fonction if_indextoname mappe un index d’interface dans son nom 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_indextoname 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_indextoname par un appel à la fonction ConvertInterfaceIndexToLuid pour convertir un index d’interface en une union NET_LUID , suivi d’un appel à la fonction ConvertInterfaceLuidToNameA pour convertir NET_LUID en nom d’interface ANSI.

La longueur, en octets, de la mémoire tampon vers laquelle pointe le paramètre InterfaceName doit être égale ou supérieure à IF_NAMESIZE. La valeur IF_NAMESIZE est définie dans le fichier d’en-tête Netioapi.h comme égale à NDIS_IF_MAX_STRING_SIZE. La longueur maximale d’un nom d’interface, NDIS_IF_MAX_STRING_SIZE, sans le caractère NULL de fin est déclarée dans le fichier d’en-tête Ntddndis.h. Le NDIS_IF_MAX_STRING_SIZE est défini comme étant la constante IF_MAX_STRING_SIZE définie dans le fichier d’en-tête Ifdef.h.

Notes

Les fichiers d’en-tête Ntddndis.h et Ifdef.h sont automatiquement inclus dans le fichier d’en-tête Netioapi.h . Vous ne devez jamais utiliser directement les fichiers d’en-tête Ntddndis.h et Ifdef.h .

Si la fonction if_indextoname échoue et retourne un pointeur NULL , vous ne pouvez pas déterminer un code d’erreur.

Spécifications

Plateforme cible

Universal

Version

Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.

En-tête

Netioapi.h (inclure Netioapi.h)

Bibliothèque

Netio.lib

IRQL

PASSIVE_LEVEL

Voir aussi

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToNameA

NET_LUID