ConvertInterfaceIndexToLuid-Funktion
Die ConvertInterfaceIndexToLuid-Funktion konvertiert einen lokalen Index 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 ConvertInterfaceIndexToLuid(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PNET_LUID InterfaceLuid
);
Parameter
InterfaceIndex [in]
Der lokale Indexwert für die Netzwerkschnittstelle.InterfaceLuid [out]
Ein Zeiger auf die NET_LUID Union für die Netzwerkschnittstelle.
Rückgabewert
ConvertInterfaceIndexToLuid gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Wenn die Funktion fehlschlägt, wird der Parameter InterfaceLuid auf NULL festgelegt, und ConvertInterfaceIndexToLuid gibt den folgenden Fehlercode zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Einer der Parameter war ungültig. ConvertInterfaceIndexToLuid gibt diesen Fehler zurück, wenn der Parameter InterfaceLuidNULL ist oder wenn der Parameter InterfaceIndex ungültig ist. |
Bemerkungen
Die ConvertInterfaceIndexToLuid-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 |