funktionen if_indextoname
Funktionen if_indextoname konverterar det lokala indexet för ett nätverksgränssnitt till namnet på ANSI-gränssnittet.
Syntax
PCHAR NETIOAPI_API_ if_indextoname(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PCHAR InterfaceName
);
Parametrar
InterfaceIndex [in]
Det lokala indexet för ett nätverksgränssnitt.InterfaceName [out]
En pekare till en buffert för att lagra DEN NULL-avslutade ANSI-strängen. Om if_indextoname lyckas innehåller InterfaceName namnet på ANSI-gränssnittet. Längden i byte för bufferten som den här parametern pekar på måste vara lika med eller större än IF_NAMESIZE. Mer information om IF_NAMESIZE finns i avsnittet Kommentarer nedan.
Returvärde
Om den här funktionen lyckas returnerar if_indextoname en pekare till en NULL-avslutad ANSI-sträng som innehåller gränssnittsnamnet. Om den här funktionen misslyckas returnerar if_indextoname en NULL- pekare
Anmärkningar
Funktionen if_indextoname mappar ett gränssnittsindex till motsvarande namn. Den här funktionen är utformad som en del av grundläggande sockettillägg för IPv6, enligt beskrivningen av IETF i RFC 2553.
Funktionen if_indextoname implementeras för portabilitet för drivrutiner med Unix-miljöer, men funktionerna ConvertInterfaceXxx är den bästa metoden för att konvertera nätverksgränssnittsidentifierare. Du kan ersätta funktionen if_indextoname med ett anrop till funktionen ConvertInterfaceIndexToLuid för att konvertera ett gränssnittsindex till en NET_LUID union, följt av ett anrop till funktionen ConvertInterfaceLuidToNameA för att konvertera NET_LUID till ANSI-gränssnittsnamnet.
Längden i byte för bufferten som InterfaceName parametern pekar på måste vara lika med eller större än IF_NAMESIZE. Värdet IF_NAMESIZE definieras i huvudfilen Netioapi.h som lika med NDIS_IF_MAX_STRING_SIZE. Den maximala längden på ett gränssnittsnamn, NDIS_IF_MAX_STRING_SIZE, utan det avslutande NULL-tecknet deklareras i rubrikfilen Ntddndis.h. NDIS_IF_MAX_STRING_SIZE definieras som den IF_MAX_STRING_SIZE konstant som definieras i ifdef.h-huvudfilen.
Not
Ntddndis.h och Ifdef.h-huvudfiler inkluderas automatiskt i Netioapi.h-huvudfilen. Du bör aldrig använda Ntddndis.h och Ifdef.h huvudfiler direkt.
Om funktionen if_indextoname misslyckas och returnerar en NULL- pekare kan du inte fastställa en felkod.
Krav
Målplattform |
Universell |
Version |
Finns i Windows Vista och senare versioner av Windows-operativsystemen. |
Rubrik |
Netioapi.h (inkludera Netioapi.h) |
Bibliotek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |