if_indextoname-Funktion
Die funktion if_indextoname konvertiert den lokalen Index für eine Netzwerkschnittstelle in den Namen der ANSI-Schnittstelle.
Syntax
PCHAR NETIOAPI_API_ if_indextoname(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PCHAR InterfaceName
);
Parameter
InterfaceIndex [in]
Der lokale Index für eine Netzwerkschnittstelle.InterfaceName [out]
Ein Zeiger auf einen Puffer, der die MIT NULL beendete ANSI-Zeichenfolge enthält. Wenn if_indextoname erfolgreich ist, enthält InterfaceName den NAMEN der ANSI-Schnittstelle. Die Länge des Puffers in Bytes, auf den dieser Parameter verweist, muss gleich oder größer als IF_NAMESIZE sein. Weitere Informationen zu IF_NAMESIZE finden Sie im folgenden Abschnitt hinweise.
Rückgabewert
Wenn diese Funktion erfolgreich ist, gibt if_indextoname einen Zeiger auf eine MIT NULL beendete ANSI-Zeichenfolge zurück, die den Schnittstellennamen enthält. Wenn diese Funktion fehlschlägt, gibt if_indextoname einen NULL-Zeiger zurück.
Bemerkungen
Die funktion if_indextoname ordnet einen Schnittstellenindex dem entsprechenden Namen zu. Diese Funktion ist als Teil grundlegender Socketerweiterungen für IPv6 konzipiert, wie in der IETF in RFC 2553 beschrieben.
Die funktion if_indextoname 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 funktion if_indextoname durch einen Aufruf der ConvertInterfaceIndexToLuid-Funktion ersetzen, um einen Schnittstellenindex in eine NET_LUID Union zu konvertieren, gefolgt von einem Aufruf der ConvertInterfaceLuidToNameA-Funktion , um NET_LUID in den NAMEN der ANSI-Schnittstelle zu konvertieren.
Die Länge des Puffers in Bytes, auf den der Parameter InterfaceName verweist, muss gleich oder größer als IF_NAMESIZE sein. Der IF_NAMESIZE Wert wird in der Netioapi.h-Headerdatei als gleich NDIS_IF_MAX_STRING_SIZE definiert. Die maximale Länge eines Schnittstellennamens NDIS_IF_MAX_STRING_SIZE, ohne dass das abschließende NULL-Zeichen in der Headerdatei "Ntddndis.h" deklariert wird. Die NDIS_IF_MAX_STRING_SIZE ist als die IF_MAX_STRING_SIZE Konstante definiert, die in der Headerdatei Ifdef.h definiert ist.
Hinweis
Die Headerdateien "Ntddndis.h" und "Ifdef.h " werden automatisch in die Headerdatei "Netioapi.h " eingeschlossen. Sie sollten die Headerdateien Ntddndis.h und Ifdef.h niemals direkt verwenden.
Wenn die if_indextoname-Funktion fehlschlägt und einen NULL-Zeiger 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 (netioapi.h einschließen) |
Bibliothek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |