if_nametoindex

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

Syntax

NET_IFINDEX NETIOAPI_API_ if_nametoindex(
  _In_ PCSTR InterfaceName
);

Parametry

• InterfaceName [in]
  Ukazatel na řetězec ANSI s ukončenou hodnotou NULL, který obsahuje název rozhraní.

Návratová hodnota

Pokud je funkce úspěšná, if_nametoindex vrátí index místního rozhraní. Pokud funkce selže, if_nametoindex vrátí nulu.

Poznámky

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

Funkce if_nametoindex 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_nametoindex můžete nahradit voláním funkce ConvertInterfaceNameToLuidA, která převede název rozhraní ANSI na NET_LUID sjednocení, následované voláním ConvertInterfaceLuidToIndex funkce převést NET_LUID na index místního rozhraní.

Pokud if_nametoindex funkce selže a vrátí nulu, nemůžete 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é

ConvertInterfaceLuidToIndex

ConvertInterfaceNameToLuidA

NET_LUID