Auf Englisch lesen

Freigeben über


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

Weitere Informationen

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToNameA

NET_LUID