Fonction ConvertInterfaceGuidToLuid
La fonction ConvertInterfaceGuidToLuid convertit un identificateur global unique (GUID) pour une interface réseau en identificateur local unique (LUID) pour l’interface.
Notes
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 ConvertInterfaceGuidToLuid(
_In_ const GUID *InterfaceGuid,
_Out_ PNET_LUID InterfaceLuid
);
Paramètres
InterfaceGuid [in]
Pointeur vers un GUID pour l’interface réseau.InterfaceLuid [out]
Pointeur vers l’union NET_LUID pour l’interface réseau.
Valeur retournée
ConvertInterfaceGuidToLuid retourne STATUS_SUCCESS si la fonction réussit. Si la fonction échoue, le paramètre InterfaceLuid est défini sur NULL et ConvertInterfaceGuidToLuid retourne le code d’erreur suivant :
| Code de retour | Description |
|---|---|
| STATUS_INVALID_PARAMETER | L'un des paramètres n'était pas valide. ConvertInterfaceGuidToLuid renvoie cette erreur si InterfaceAlias ou InterfaceLuid a la valeur NULL, ou si InterfaceGuid n’est pas valide. |
Notes
La fonction ConvertInterfaceGuidToLuid 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 versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Netioapi.h (inclure Netioapi.h) |
Bibliothèque |
Netio.lib |
IRQL |
PASSIVE_LEVEL |