Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Funkce ConvertInterfaceLuidToNameW převede místně jedinečný identifikátor (LUID) síťového rozhraní na název rozhraní Unicode.
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 ConvertInterfaceLuidToNameW(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceName,
_In_ SIZE_T Length
);
Parametry
InterfaceLuid [in]
Ukazatel na sjednocení NET_LUID pro síťové rozhraní.InterfaceName [out]
Ukazatel na vyrovnávací paměť pro uložení řetězce Unicode s ukončenou hodnotou NULL. Pokud ConvertInterfaceLuidToNameW úspěšně vrátí, InterfaceName obsahuje název rozhraní Unicode.délka [in]
Délka vyrovnávací paměti podle počtu znaků, na kterou odkazuje parametr InterfaceName. Tato hodnota musí být dostatečně velká pro uložení názvu rozhraní a ukončujícího znaku 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
ConvertInterfaceLuidToNameW vrátí STATUS_SUCCESS, pokud bude funkce úspěšná. Pokud funkce selže, ConvertInterfaceLuidToNameW vrátí jeden z následujících kódů chyb:
| Návratový kód | Popis |
|---|---|
| STATUS_INVALID_PARAMETER | Jeden z parametrů je neplatný. ConvertInterfaceLuidToNameW vrátí tuto chybu, pokud InterfaceLuid nebo InterfaceName je nullnebo pokud InterfaceLuid je neplatné. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW vrátí tuto chybu, pokud InterfaceName vyrovnávací paměť nebyla tak velká, jak je uvedeno v parametru Délka, a proto vyrovnávací paměť nemohla obsahovat název rozhraní. |
Poznámky
Funkce ConvertInterfaceLuidToNameW 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í ConvertInterfaceLuidToNameA převeďte LUID síťového rozhraní na název rozhraní ANSI.
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 |