ConvertInterfaceAliasToLuid-Funktion (netioapi.h)

Artikel
03/06/2024

Die ConvertInterfaceAliasToLuid-Funktion konvertiert einen Schnittstellenaliasnamen für eine Netzwerkschnittstelle in den lokal eindeutigen Bezeichner (LUID) für die Schnittstelle.

Syntax

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

Parameter

[in] InterfaceAlias

Ein Zeiger auf eine MIT NULL endende Unicode-Zeichenfolge, die den Aliasnamen der Netzwerkschnittstelle enthält.

[out] InterfaceLuid

Ein Zeiger auf die NET_LUID für diese Schnittstelle.

Rückgabewert

Bei Erfolg gibt ConvertInterfaceAliasToLuid NO_ERROR zurück. Jeder Rückgabewert ungleich null gibt einen Fehler an, und im Parameter InterfaceLuid wird null zurückgegeben.

Fehlercode	Bedeutung
ERROR_INVALID_PARAMETER	Einer der Parameter war ungültig. Dieser Fehler wird zurückgegeben, wenn entweder der Parameter InterfaceAlias oder InterfaceLuidNULL war oder wenn der Parameter InterfaceAlias ungültig war.

Hinweise

Die ConvertInterfaceAliasToLuid-Funktion ist unter Windows Vista und höher verfügbar.

Die ConvertInterfaceAliasToLuid-Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen für das IPv6- und IPv4-Protokoll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netioapi.h (include Iphlpapi.h)
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll