Fonction ConvertInterfaceLuidToGuid
La fonction ConvertInterfaceLuidToGuid convertit un identificateur local unique (LUID) pour une interface réseau en identificateur global unique (GUID) 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 ConvertInterfaceLuidToGuid(
_In_ const NET_LUID *InterfaceLuid,
_Out_ GUID *InterfaceGuid
);
Paramètres
InterfaceLuid [in]
Pointeur vers une union NET_LUID pour l’interface réseau.InterfaceGuid [out]
Pointeur vers le GUID de l’interface réseau.
Valeur retournée
ConvertInterfaceLuidToGuid retourne STATUS_SUCCESS si la fonction réussit. Si la fonction échoue, le paramètre InterfaceGuid est défini sur NULL et ConvertInterfaceLuidToGuid retourne le code d’erreur suivant :
| Code de retour | Description |
|---|---|
| STATUS_INVALID_PARAMETER | L’un des paramètres n’est pas valide. ConvertInterfaceLuidToGuid renvoie cette erreur si InterfaceLuid ou InterfaceGuid a la valeur NULL, ou si InterfaceLuid n’est pas valide. |
Notes
La fonction ConvertInterfaceLuidToGuid est indépendante du protocole et fonctionne avec des 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 |