Partager via


ConvertInterfaceLuidToIndex, fonction

La fonction ConvertInterfaceLuidToIndex convertit un identificateur unique localement (LUID) pour une interface réseau en index local de 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 ConvertInterfaceLuidToIndex(
  _In_  const NET_LUID     *InterfaceLuid,
  _Out_       PNET_IFINDEX InterfaceIndex
);

Paramètres

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

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

Valeur de retour

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

Retourner le code Description
STATUS_INVALID_PARAMETER

L’un des paramètres n’est pas valide. ConvertInterfaceLuidToIndex retourne cette erreur si InterfaceLuid ou InterfaceIndex est NULL, ou si InterfaceLuid n’est pas valide.

Remarques

La fonction ConvertInterfaceLuidToIndex 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

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID