if_nametoindex-Funktion
Die if_nametoindex-Funktion konvertiert den ANSI-Schnittstellennamen für eine Netzwerkschnittstelle in den lokalen Index für die Schnittstelle.
Syntax
NET_IFINDEX NETIOAPI_API_ if_nametoindex(
_In_ PCSTR InterfaceName
);
Parameter
- InterfaceName [in]
Ein Zeiger auf eine NULL-beendete ANSI-Zeichenfolge, die den Schnittstellennamen enthält.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt if_nametoindex den lokalen Schnittstellenindex zurück. Wenn die Funktion fehlschlägt, gibt if_nametoindex null zurück.
Bemerkungen
Die if_nametoindex-Funktion ordnet dem entsprechenden Index einen Schnittstellennamen zu. Diese Funktion ist als Teil der grundlegenden Socketerweiterungen für IPv6 konzipiert, wie von der IETF in RFC 2553 beschrieben.
Die if_nametoindex-Funktion ist für die Portabilität von Treibern mit Unix-Umgebungen implementiert, aber die ConvertInterfaceXxx-Funktionen sind die bevorzugte Methode zum Konvertieren von Netzwerkschnittstellenbezeichnern. Sie können die if_nametoindex-Funktion durch einen Aufruf der ConvertInterfaceNameToLuidA-Funktion ersetzen, um den ANSI-Schnittstellennamen in eine NET_LUID Union zu konvertieren, gefolgt von einem Aufruf der ConvertInterfaceLuidToIndex-Funktion , um NET_LUID in den lokalen Schnittstellenindex zu konvertieren.
Wenn die if_nametoindex-Funktion fehlschlägt und null zurückgibt, können Sie keinen Fehlercode ermitteln.
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 |