if_indextoname

Funkce if_indextoname převede místní index síťového rozhraní na název rozhraní ANSI.

Syntax

PCHAR NETIOAPI_API_ if_indextoname(
  _In_  NET_IFINDEX InterfaceIndex,
  _Out_ PCHAR       InterfaceName
);

Parametry

• InterfaceIndex [in]
  Místní index síťového rozhraní.

• InterfaceName [out]
  Ukazatel na vyrovnávací paměť pro uložení řetězce ANSI ukončeného hodnotou NULL. Pokud if_indextoname proběhne úspěšně, Název rozhraní obsahuje název rozhraní ANSI. Délka vyrovnávací paměti v bajtech, na kterou tento parametr odkazuje, musí být rovna nebo větší než IF_NAMESIZE. Další informace o IF_NAMESIZE naleznete v následující části Poznámky.

Návratová hodnota

Pokud je tato funkce úspěšná, if_indextoname vrátí ukazatel na řetězec ANSI s ukončenou hodnotou NULL, který obsahuje název rozhraní. Pokud tato funkce selže, if_indextoname vrátí ukazatel NULL

Poznámky

Funkce if_indextoname mapuje index rozhraní na odpovídající název. Tato funkce je navržena jako součást základních rozšíření soketů pro IPv6, jak popisuje IETF v RFC 2553.

Funkce if_indextoname je implementována pro přenositelnost ovladačů s prostředími Unix, ale funkce ConvertInterfaceXxx jsou upřednostňovanou metodou převodu identifikátorů síťového rozhraní. Funkci if_indextoname můžete nahradit voláním funkce ConvertInterfaceIndexToLuid k převodu indexu rozhraní na NET_LUID sjednocení a následným voláním funkce ConvertInterfaceLuidToNameA převést NET_LUID na název rozhraní ANSI.

Délka vyrovnávací paměti, na které InterfaceName odkazuje, musí být v bajtech stejná nebo větší než IF_NAMESIZE. Hodnota IF_NAMESIZE je definována v souboru hlaviček Netioapi.h stejně jako NDIS_IF_MAX_STRING_SIZE. Maximální délka názvu rozhraní NDIS_IF_MAX_STRING_SIZE bez ukončujícího znaku NULL je deklarována v souboru hlavičky Ntddndis.h. NDIS_IF_MAX_STRING_SIZE je definován jako IF_MAX_STRING_SIZE konstanta definovaná v souboru hlavičky Ifdef.h.

Poznámka

Soubory hlaviček Ntddndis.h a Ifdef.h jsou automaticky zahrnuty do souboru hlaviček Netioapi.h. Nikdy byste neměli používat soubory Ntddndis.h a Ifdef.h hlavičky přímo.

Pokud if_indextoname funkce selže a vrátí ukazatel NULL, nelze určit kód chyby.

Požadavky

Cílová platforma	univerzální
Verze	K dispozici v systémech Windows Vista a novějších verzích operačních systémů Windows.
Záhlaví	Netioapi.h (včetně Netioapi.h)
Knihovna	Netio.lib
IRQL	PASSIVE_LEVEL

Viz také

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToNameA

NET_LUID