Fonction ConvertInterfaceLuidToIndex
La fonction ConvertInterfaceLuidToIndex convertit un identificateur local unique (LUID) pour une interface réseau en index local pour l’interface.
Notes
La famille d’API ConvertInterfaceXxx énumère les identificateurs de toutes les interfaces liées à TCP/IP, qui peuvent inclure des miniports virtuels, des filtres légers, des adaptateurs 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 de NET_LUID pour l’interface réseau.InterfaceIndex [out]
Valeur d’index local pour l’interface réseau.
Valeur retournée
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 :
| Code de retour | Description |
|---|---|
| STATUS_INVALID_PARAMETER | L’un des paramètres n’est pas valide. ConvertInterfaceLuidToIndex retourne cette erreur si InterfaceLuid ou InterfaceIndex a la valeur NULL, ou si InterfaceLuid n’est pas valide. |
Notes
La fonction ConvertInterfaceLuidToIndex est indépendante du protocole et fonctionne avec les interfaces réseau pour les protocoles IPv6 et IPv4.
Spécifications
Plateforme cible |
Universal |
Version |
Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |
Bibliothèque |
Netio.lib |
IRQL |
PASSIVE_LEVEL |