ConvertInterfaceNameToLuidW – funkce

Funkce ConvertInterfaceNameToLuidW převede název síťového rozhraní Unicode 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 ConvertInterfaceNameToLuidW(
  _In_  const WCHAR    *InterfaceName,
  _Out_       NET_LUID *InterfaceLuid
);

Parametry

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

• InterfaceLuid [out]
  Ukazatel na sjednocení NET_LUID pro toto rozhraní.

Návratová hodnota

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

Návratový kód	Popis
STATUS_INVALID_NAME	Název rozhraní je neplatný. ConvertInterfaceNameToLuidW vrátí tuto chybu, pokud parametr InterfaceName obsahuje neplatný název nebo délka parametru InterfaceName překračuje maximální povolenou délku řetězce tohoto parametru.
STATUS_INVALID_PARAMETER	Jeden z parametrů je neplatný. ConvertInterfaceNameToLuidW vrátí tuto chybu, pokud je parametr InterfaceLuidNULL.

Poznámky

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

Maximální délka názvu síťového rozhraní NDIS_IF_MAX_STRING_SIZE bez ukončujícího znaku NULL je definována v souboru hlaviček 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.

Pomocí funkce ConvertInterfaceNameToLuidA převeďte název rozhraní ANSI na LUID.

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

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

NET_LUID