ConvertInterfaceLuidToAlias – funkce

Funkce ConvertInterfaceLuidToAlias převede místně jedinečný identifikátor (LUID) síťového rozhraní na alias 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 ConvertInterfaceLuidToAlias(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PWSTR    InterfaceAlias,
  _In_        SIZE_T   Length
);

Parametry

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

• InterfaceAlias [out]
  Ukazatel na vyrovnávací paměť pro uložení řetězce Unicode s ukončenou hodnotou NULL. Pokud ConvertInterfaceLuidToAlias úspěšně vrátí, InterfaceAlias obsahuje název aliasu síťového rozhraní.

• délka [in]
  Délka vyrovnávací paměti podle počtu znaků, na kterou odkazuje InterfaceAlias parametru. Tato hodnota musí být dostatečně velká, aby obsahovala název aliasu síťového rozhraní a ukončující znak NULL. Maximální povolená délka je NDIS_IF_MAX_STRING_SIZE + 1. Další informace o NDIS_IF_MAX_STRING_SIZE naleznete v následující části Poznámky.

Návratová hodnota

ConvertInterfaceLuidToAlias vrátí STATUS_SUCCESS, pokud je funkce úspěšná. Pokud funkce selže, ConvertInterfaceLuidToAlias vrátí jeden z následujících kódů chyb:

Návratový kód	Popis
STATUS_INVALID_PARAMETER	Jeden z parametrů je neplatný. ConvertInterfaceLuidToAlias vrátí tuto chybu, pokud InterfaceLuid nebo InterfaceAlias je nullnebo pokud je InterfaceLuid neplatný.
STATUS_NOT_ENOUGH_MEMORY	Není k dispozici dostatek úložiště. ConvertInterfaceLuidToAlias vrátí tuto chybu, pokud velikost vyrovnávací paměti, na kterou InterfaceAlias parametr odkazuje, nebyla tak velká, jak je uvedeno v parametru Length, a proto vyrovnávací paměť nemohla obsahovat název aliasu.

Poznámky

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

Maximální délka názvu aliasu pro síťové 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ána jako konstanta IF_MAX_STRING_SIZE, která je definována 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.

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é

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID