Partager via


ConvertInterfaceLuidToNameW, fonction

La fonction ConvertInterfaceLuidToNameW convertit un identificateur unique localement (LUID) pour une interface réseau en nom d’interface Unicode.

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 ConvertInterfaceLuidToNameW(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PWSTR    InterfaceName,
  _In_        SIZE_T   Length
);

Paramètres

  • InterfaceLuid [in]
    Pointeur vers une union NET_LUID pour l’interface réseau.

  • InterfaceName [out]
    Pointeur vers une mémoire tampon pour contenir la chaîne Unicode terminée par NULL. Si ConvertInterfaceLuidToNameW retourne correctement, InterfaceName contient le nom de l’interface Unicode.

  • longueur [in]
    Longueur de la mémoire tampon, par nombre de caractères, vers laquelle pointe le paramètre InterfaceName. Cette valeur doit être suffisamment grande pour contenir le nom de l’interface et le caractère NULL de fin. La longueur maximale autorisée est NDIS_IF_MAX_STRING_SIZE + 1. Pour plus d’informations sur NDIS_IF_MAX_STRING_SIZE, consultez la section Remarques suivante.

Valeur de retour

ConvertInterfaceLuidToNameW retourne STATUS_SUCCESS si la fonction réussit. Si la fonction échoue, ConvertInterfaceLuidToNameW retourne l’un des codes d’erreur suivants :

Retourner le code Description
STATUS_INVALID_PARAMETER

L’un des paramètres n’est pas valide. ConvertInterfaceLuidToNameW renvoie cette erreur si InterfaceLuid ou InterfaceName est NULL, ou si InterfaceLuid n’est pas valide.

STATUS_NOT_ENOUGH_MEMORY

ConvertInterfaceLuidToNameW renvoie cette erreur si la mémoire tampon InterfaceName n’a pas été aussi grande que spécifiée dans le paramètre Length et, par conséquent, la mémoire tampon n’a pas pu contenir le nom de l’interface.

Remarques

La fonction ConvertInterfaceLuidToNameW 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. La 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 ConvertInterfaceLuidToNameA pour convertir une interface réseau LUID en nom d’interface ANSI.

Exigences

Plateforme cible

universel

Version

Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.

En-tête

Netioapi.h (include Netioapi.h)

Bibliothèque

Netio.lib

IRQL

PASSIVE_LEVEL

Voir aussi

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID