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