ConvertInterfaceAliasToLuid – funkce

Funkce ConvertInterfaceAliasToLuid převede název aliasu rozhraní pro síťové rozhraní na místně jedinečný identifikátor (LUID) rozhraní.

Poznámka

ConvertInterfaceXxx rozhraní API výčet identifikátorů ve všech rozhraních vázaných na TCP/IP, které mohou zahrnovat virtuální miniporty, odlehčené filtry, adaptéry tunelu a fyzická rozhraní.

Syntax

NETIOAPI_API ConvertInterfaceAliasToLuid(
  _In_  const WCHAR     *InterfaceAlias,
  _Out_       PNET_LUID InterfaceLuid
);

Parametry

• InterfaceAlias [in]
  Ukazatel na řetězec Unicode s ukončenou hodnotou NULL, který obsahuje název aliasu síťového rozhraní.

• InterfaceLuid [out]
  Ukazatel na sjednocení NET_LUID pro síťové rozhraní.

Návratová hodnota

ConvertInterfaceAliasToLuid vrátí STATUS_SUCCESS, pokud je funkce úspěšná. Pokud funkce selže, je parametr InterfaceLuid nastaven na NULLa ConvertInterfaceAliasToLuid vrátí následující kód chyby:

Návratový kód	Popis
STATUS_INVALID_PARAMETER	Jeden z parametrů byl neplatný. ConvertInterfaceAliasToLuid vrátí tuto chybu, pokud InterfaceAlias nebo InterfaceLuid je nullnebo pokud je InterfaceAlias neplatný.

Poznámky

Funkce ConvertInterfaceAliasToLuid je nezávislá na protokolu a pracuje se síťovými rozhraními pro protokoly IPv6 i IPv4.

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é

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID