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.

Om funktionen if_indextoname misslyckas och returnerar en NULL- pekare kan du inte fastställa en felkod.

Krav

Se även

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToNameA

NET_LUID