if_indextoname-Funktion
Die if_indextoname-Funktion konvertiert den lokalen Index für eine Netzwerkschnittstelle in den ANSI-Schnittstellennamen.
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 ANSI-Schnittstellennamen. Die Länge des Puffers, auf den dieser Parameter verweist, muss in Bytes 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 if_indextoname-Funktion ordnet einen Schnittstellenindex dem entsprechenden Namen zu. Diese Funktion ist als Teil der grundlegenden Socketerweiterungen für IPv6 konzipiert, wie vom IETF in RFC 2553beschrieben.
Die if_indextoname-Funktion wird für die Portabilität von Treibern mit Unix-Umgebungen implementiert, aber die ConvertInterface-Xxx--Funktionen sind die bevorzugte Methode zum Konvertieren von Netzwerkschnittstellen-IDs. Sie können die if_indextoname-Funktion 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 ANSI-Schnittstellennamen zu konvertieren.
Die Länge des Puffers, auf den der InterfaceName Parameter verweist, muss gleich oder größer als IF_NAMESIZE sein. Der IF_NAMESIZE Wert wird in der Headerdatei Netioapi.h gleich NDIS_IF_MAX_STRING_SIZE definiert. Die maximale Länge eines Schnittstellennamens, NDIS_IF_MAX_STRING_SIZE, ohne das endende NULL-Zeichen wird in der Ntddndis.h-Headerdatei deklariert. Die NDIS_IF_MAX_STRING_SIZE ist als die IF_MAX_STRING_SIZE Konstante definiert, die in der Headerdatei "Ifdef.h" definiert ist.
Anmerkung
Die Ntddndis.h und Ifdef.h Headerdateien werden automatisch in der Netioapi.h Headerdatei enthalten. Sie sollten niemals die Ntddndis.h und Ifdef.h Headerdateien direkt verwenden.
Wenn die if_indextoname-Funktion fehlschlägt und einen NULL- Zeiger zurückgibt, können Sie keinen Fehlercode ermitteln.
Anforderungen
Zielplattform |
universelle |
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Kopfball |
Netioapi.h (include Netioapi.h) |
Bibliothek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |