if_nametoindex-Funktion (netioapi.h)
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 |