Partager via


ConvertInterfaceIndexToLuid, fonction

La fonction ConvertInterfaceIndexToLuid convertit un index local pour une interface réseau 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 ConvertInterfaceIndexToLuid(
  _In_  NET_IFINDEX InterfaceIndex,
  _Out_ PNET_LUID   InterfaceLuid
);

Paramètres

  • InterfaceIndex [in]
    Valeur d’index local de l’interface réseau.

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

Valeur de retour

ConvertInterfaceIndexToLuid retourne STATUS_SUCCESS si la fonction réussit. Si la fonction échoue, le paramètre InterfaceLuid est défini sur NULL et ConvertInterfaceIndexToLuid retourne le code d’erreur suivant :

Retourner le code Description
STATUS_INVALID_PARAMETER

L’un des paramètres n’était pas valide. ConvertInterfaceIndexToLuid retourne cette erreur si le paramètre InterfaceLuid est NULL, ou si le paramètre InterfaceIndex n’est pas valide.

Remarques

La fonction ConvertInterfaceIndexToLuid est indépendante du protocole et fonctionne avec des interfaces réseau pour les protocoles IPv6 et IPv4.

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

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID