Fonction ConvertInterfaceNameToLuidW (netioapi.h)

Article
03/04/2024

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