Partager via


Fonction ConvertInterfaceNameToLuidW (netioapi.h)

La fonction ConvertInterfaceNameToLuidW convertit un nom d’interface réseau Unicode en identificateur unique local (LUID) de l’interface.

Syntaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidW(
  [in]  const WCHAR *InterfaceName,
  [out] NET_LUID    *InterfaceLuid
);

Paramètres

[in] InterfaceName

Pointeur vers une chaîne Unicode terminée par null contenant le nom de l’interface réseau.

[out] InterfaceLuid

Pointeur vers le NET_LUID pour cette interface.

Valeur retournée

En cas de réussite, ConvertInterfaceNameToLuidW retourne NETIO_ERROR_SUCCESS. Toute valeur de retour différente de zéro indique un échec.

Code d'erreur Signification
ERROR_INVALID_NAME
Le nom de l’interface n’était pas valide. Cette erreur est retournée si le paramètre InterfaceName contient un nom non valide ou si la longueur du paramètre InterfaceName dépasse la longueur de chaîne maximale autorisée pour ce paramètre.
ERROR_INVALID_PARAMETER
L'un des paramètres n'était pas valide. Cette erreur est retournée si le paramètre InterfaceLuid était NULL.

Remarques

La fonction ConvertInterfaceNameToLuidW est disponible sur Windows Vista et versions ultérieures.

La fonction ConvertInterfaceNameToLuidW est indépendante du protocole et fonctionne avec les interfaces réseau pour les protocoles IPv6 et IPv4. ConvertInterfaceNameToLuidW convertit un nom d’interface Unicode en LUID.

ConvertInterfaceNameToLuidA convertit un nom d’interface ANSI en LUID.

La longueur maximale d’un nom d’interface, NDIS_IF_MAX_STRING_SIZE, sans la valeur 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 . Les fichiers d’en-tête Ntddndis.h et Ifdef.h sont automatiquement inclus dans le fichier d’en-tête Netioapi.h qui est automatiquement inclus par le fichier d’en-tête Iphlpapi.h . Les fichiers d’en-tête Ntddndis.h, Ifdef.h et Netioapi.h ne doivent jamais être utilisés directement.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête netioapi.h (inclure Iphlpapi.h)
Bibliothèque Iphlpapi.lib
DLL Iphlpapi.dll

Voir aussi

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

NET_LUID

if_indextoname

if_nametoindex