if_nametoindex-Funktion (netioapi.h)

Artikel
02/29/2024

Die if_nametoindex-Funktion konvertiert den ANSI-Schnittstellennamen für eine Netzwerkschnittstelle in den lokalen Index für die Schnittstelle.

Syntax

IPHLPAPI_DLL_LINKAGE NET_IFINDEX NETIOAPI_API_ if_nametoindex(
  [in] PCSTR InterfaceName
);

Parameter

[in] InterfaceName

Ein Zeiger auf eine MIT NULL beendete ANSI-Zeichenfolge, die den Schnittstellennamen enthält.

Rückgabewert

Bei Erfolg gibt if_nametoindex den lokalen Schnittstellenindex zurück. Bei einem Fehler wird null zurückgegeben.

Hinweise

Die if_nametoindex-Funktion ist unter Windows Vista und höher verfügbar.

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. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc2553.txt.

Die if_nametoindex-Funktion ist für die Portabilität von Anwendungen mit Unix-Umgebungen implementiert, aber die ConvertInterface-Funktionen werden bevorzugt. Die if_nametoindex-Funktion kann durch einen Aufruf der ConvertInterfaceNameToLuidA-Funktion ersetzt werden, um den ANSI-Schnittstellennamen in einen NET_LUID gefolgt von einem Aufruf von ConvertInterfaceLuidToIndex , um die NET_LUID in den lokalen Schnittstellenindex zu konvertieren.

Wenn die if_nametoindex-Funktion fehlschlägt und null zurückgibt, ist es nicht möglich, einen Fehlercode zu ermitteln.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netioapi.h (include Iphlpapi.h)
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll