Fonction ConvertInterfaceAliasToLuid (netioapi.h)
La fonction ConvertInterfaceAliasToLuid convertit un nom d’alias d’interface pour une interface réseau en identificateur unique local (LUID) de l’interface.
Syntaxe
IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
[in] const WCHAR *InterfaceAlias,
[out] PNET_LUID InterfaceLuid
);
Paramètres
[in] InterfaceAlias
Pointeur vers une chaîne Unicode terminée par null contenant le nom d’alias de l’interface réseau.
[out] InterfaceLuid
Pointeur vers le NET_LUID pour cette interface.
Valeur retournée
En cas de réussite, ConvertInterfaceAliasToLuid retourne NO_ERROR. Toute valeur de retour différente de zéro indique un échec et une valeur NULL est retournée dans le paramètre InterfaceLuid .
| Code d'erreur | Signification |
|---|---|
|
L'un des paramètres n'était pas valide. Cette erreur est retournée si le paramètre InterfaceAlias ou InterfaceLuid était NULL ou si le paramètre InterfaceAlias n’était pas valide. |
Remarques
La fonction ConvertInterfaceAliasToLuid est disponible sur Windows Vista et versions ultérieures.
La fonction ConvertInterfaceAliasToLuid est indépendante du protocole et fonctionne avec les interfaces réseau pour les protocoles IPv6 et IPv4.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | netioapi.h (inclure Iphlpapi.h) |
| Bibliothèque | Iphlpapi.lib |
| DLL | Iphlpapi.dll |