Fonction ConvertInterfaceAliasToLuid
La fonction ConvertInterfaceAliasToLuid convertit un nom d’alias d’interface pour une interface réseau en identificateur unique local (LUID) de 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 ConvertInterfaceAliasToLuid(
_In_ const WCHAR *InterfaceAlias,
_Out_ PNET_LUID InterfaceLuid
);
Paramètres
InterfaceAlias [in]
Pointeur vers une chaîne Unicode terminée par null qui contient le nom d’alias de l’interface réseau.InterfaceLuid [out]
Pointeur vers l’union NET_LUID pour l’interface réseau.
Valeur retournée
ConvertInterfaceAliasToLuid retourne STATUS_SUCCESS si la fonction réussit. Si la fonction échoue, le paramètre InterfaceLuid est défini sur NULL et ConvertInterfaceAliasToLuid retourne le code d’erreur suivant :
| Code de retour | Description |
|---|---|
| STATUS_INVALID_PARAMETER | L'un des paramètres n'était pas valide. ConvertInterfaceAliasToLuid retourne cette erreur si InterfaceAlias ou InterfaceLuid a la valeur NULL ou si InterfaceAlias n’est pas valide. |
Notes
La fonction ConvertInterfaceAliasToLuid 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 |