ConvertInterfaceAliasToLuid-Funktion
Die ConvertInterfaceAliasToLuid-Funktion konvertiert einen Schnittstellenaliasnamen für eine Netzwerkschnittstelle in den lokal eindeutigen Bezeichner (LUID) für die Schnittstelle.
Hinweis
Die ConvertInterfaceXxx-API-Familie listet Bezeichner über alle an TCP/IP gebundenen Schnittstellen auf, die virtuelle Miniports, Lightweight-Filter, Tunneladapter und physische Schnittstellen umfassen können.
Syntax
NETIOAPI_API ConvertInterfaceAliasToLuid(
_In_ const WCHAR *InterfaceAlias,
_Out_ PNET_LUID InterfaceLuid
);
Parameter
InterfaceAlias [in]
Ein Zeiger auf eine MIT NULL beendete Unicode-Zeichenfolge, die den Aliasnamen der Netzwerkschnittstelle enthält.InterfaceLuid [out]
Ein Zeiger auf die NET_LUID Union für die Netzwerkschnittstelle.
Rückgabewert
ConvertInterfaceAliasToLuid gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Wenn die Funktion fehlschlägt, wird der Parameter InterfaceLuid auf NULL festgelegt, und ConvertInterfaceAliasToLuid gibt den folgenden Fehlercode zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Einer der Parameter war ungültig. ConvertInterfaceAliasToLuid gibt diesen Fehler zurück, wenn entweder InterfaceAlias oder InterfaceLuidNULL ist oder Wenn InterfaceAlias ungültig ist. |
Bemerkungen
Die ConvertInterfaceAliasToLuid-Funktion ist protokollunabhängig und funktioniert mit Netzwerkschnittstellen für die Protokolle IPv6 und IPv4.
Anforderungen
Zielplattform |
Universell |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Netioapi.h (einschließlich Netioapi.h) |
Bibliothek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |