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 |