ConvertInterfaceLuidToGuid-Funktion
Die ConvertInterfaceLuidToGuid-Funktion konvertiert einen lokal eindeutigen Bezeichner (LUID) für eine Netzwerkschnittstelle in einen global eindeutigen Bezeichner (GUID) 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 ConvertInterfaceLuidToGuid(
_In_ const NET_LUID *InterfaceLuid,
_Out_ GUID *InterfaceGuid
);
Parameter
InterfaceLuid [in]
Ein Zeiger auf eine NET_LUID Union für die Netzwerkschnittstelle.InterfaceGuid [out]
Ein Zeiger auf die GUID für die Netzwerkschnittstelle.
Rückgabewert
ConvertInterfaceLuidToGuid gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Wenn die Funktion fehlschlägt, wird der Parameter InterfaceGuid auf NULL festgelegt, und ConvertInterfaceLuidToGuid gibt den folgenden Fehlercode zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Einer der Parameter ist ungültig. ConvertInterfaceLuidToGuid gibt diesen Fehler zurück, wenn Entweder InterfaceLuid oder InterfaceGuidNULL ist oder Wenn InterfaceLuid ungültig ist. |
Bemerkungen
Die ConvertInterfaceLuidToGuid-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 |