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 ConvertInterfaceLuidToNameA převede místně jedinečný identifikátor (LUID) síťového rozhraní na název rozhraní ANSI.
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 ConvertInterfaceLuidToNameA(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PSTR 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 ANSI ukončeného hodnotou NULL. Pokud ConvertInterfaceLuidToNameA úspěšně vrátí, InterfaceName obsahuje název rozhraní ANSI.délka [in]
Délka vyrovnávací paměti, na kterou InterfaceName odkazuje. 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
ConvertInterfaceLuidToNameA vrátí STATUS_SUCCESS, pokud bude funkce úspěšná. Pokud funkce selže, ConvertInterfaceLuidToNameA vrátí jeden z následujících kódů chyb:
| Návratový kód | Popis |
|---|---|
| STATUS_INVALID_PARAMETER | Jeden z parametrů je neplatný. ConvertInterfaceLuidToNameA vrátí tuto chybu, pokud je InterfaceLuid nebo InterfaceNamenullnebo pokud je InterfaceLuid neplatný. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameA 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 ConvertInterfaceLuidToNameA 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č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.
Pomocí funkce ConvertInterfaceLuidToNameW převeďte LUID síťového rozhraní na název rozhraní Unicode.
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 |