ConvertInterfaceGuidToLuid-Funktion
Die ConvertInterfaceGuidToLuid-Funktion konvertiert eine GUID (Globally Unique Identifier) für eine Netzwerkschnittstelle in den lokal eindeutigen Bezeichner (LUID) für die Schnittstelle.
Hinweis
Die ConvertInterfaceXxx-API-Familie listet Bezeichner über alle Schnittstellen auf, die an TCP/IP gebunden sind, was virtuelle Miniports, lightweight-Filter, Tunneladapter und physische Schnittstellen umfassen kann.
Syntax
NETIOAPI_API ConvertInterfaceGuidToLuid(
_In_ const GUID *InterfaceGuid,
_Out_ PNET_LUID InterfaceLuid
);
Parameter
InterfaceGuid [in]
Ein Zeiger auf eine GUID für die Netzwerkschnittstelle.InterfaceLuid [out]
Ein Zeiger auf die NET_LUID Union für die Netzwerkschnittstelle.
Rückgabewert
ConvertInterfaceGuidToLuid gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Wenn die Funktion fehlschlägt, wird der Parameter InterfaceLuid auf NULL festgelegt, und ConvertInterfaceGuidToLuid gibt den folgenden Fehlercode zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Einer der Parameter war ungültig. ConvertInterfaceGuidToLuid gibt diesen Fehler zurück, wenn Entweder InterfaceAlias oder InterfaceLuidNULL ist oder Wenn InterfaceGuid ungültig ist. |
Bemerkungen
Die ConvertInterfaceGuidToLuid-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 (netioapi.h einschließen) |
Bibliothek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |