fonction if_indextoname
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 pour 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. Longueur, en octets, de la mémoire tampon à 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 de retour
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
Remarques
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 union NET_LUID, suivi d’un appel à la fonction ConvertInterfaceLuidToNameA pour convertir NET_LUID en nom d’interface ANSI.
Longueur, en octets, de la mémoire tampon à laquelle le paramètre InterfaceName doit être égal ou supérieur à IF_NAMESIZE. La valeur IF_NAMESIZE est définie dans le fichier d’en-tête Netioapi.h comme égal à 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. La NDIS_IF_MAX_STRING_SIZE est définie comme constante IF_MAX_STRING_SIZE définie dans le fichier d’en-tête Ifdef.h.
Note
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 les fichiers d’en-tête Ntddndis.h et Ifdef.h directement.
Si la fonction if_indextoname échoue et retourne un pointeur NULL, vous ne pouvez pas déterminer un code d’erreur.