ConvertInterfaceNameToLuidW, fonction
La fonction ConvertInterfaceNameToLuidW convertit un nom d’interface réseau Unicode en identificateur unique local (LUID) pour l’interface.
Note
La famille d’API ConvertInterfaceXxx énumère les identificateurs sur toutes les interfaces liées à TCP/IP, qui peuvent inclure des miniports virtuels, des filtres légers, des adaptateurs de tunnel et des interfaces physiques.
Syntaxe
NETIOAPI_API ConvertInterfaceNameToLuidW(
_In_ const WCHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Paramètres
InterfaceName [in]
Pointeur vers une chaîne Unicode terminée par NULL qui contient le nom de l’interface réseau.InterfaceLuid [out]
Pointeur vers l’union NET_LUID pour cette interface.
Valeur de retour
ConvertInterfaceNameToLuidW retourne STATUS_SUCCESS si la fonction réussit. Si la fonction échoue, ConvertInterfaceNameToLuidW retourne l’un des codes d’erreur suivants :
Retourner le code | Description |
---|---|
STATUS_INVALID_NAME | Le nom de l’interface n’est pas valide. ConvertInterfaceNameToLuidW renvoie cette erreur si le paramètre InterfaceName contient un nom non valide ou la longueur du paramètre InterfaceName dépasse la longueur maximale de chaîne autorisée pour ce paramètre. |
STATUS_INVALID_PARAMETER | L’un des paramètres n’est pas valide. ConvertInterfaceNameToLuidW retourne cette erreur si le paramètre InterfaceLuid est NULL. |
Remarques
La fonction ConvertInterfaceNameToLuidW est indépendante du protocole et fonctionne avec des interfaces réseau pour les protocoles IPv6 et IPv4.
La longueur maximale du nom de l’interface réseau, NDIS_IF_MAX_STRING_SIZE, sans le caractère NULL de fin, est définie dans le fichier d’en-tête Ntddndis.h. NDIS_IF_MAX_STRING_SIZE est définie comme constante IF_MAX_STRING_SIZE, qui est 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.
Utilisez la fonction ConvertInterfaceNameToLuidA pour convertir un nom d’interface ANSI en LUID.