Funktionen ConvertInterfaceLuidToNameW
Funktionen ConvertInterfaceLuidToNameW konverterar en lokalt unik identifierare (LUID) för ett nätverksgränssnitt till Unicode-gränssnittets namn.
Not
ConvertInterface-Xxx API-familjen räknar upp identifierare för alla gränssnitt som är bundna till TCP/IP, vilket kan inkludera virtuella miniportar, lätta filter, tunnelkort och fysiska gränssnitt.
Syntax
NETIOAPI_API ConvertInterfaceLuidToNameW(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceName,
_In_ SIZE_T Length
);
Parametrar
InterfaceLuid [in]
En pekare till en NET_LUID union för nätverksgränssnittet.InterfaceName [out]
En pekare till en buffert som ska innehålla den NULL-avslutade Unicode-strängen. Om ConvertInterfaceLuidToNameW returnerar korrekt, innehåller InterfaceName Unicode-gränssnittsnamnet.längd [in]
Längden på bufferten, efter antal tecken, som InterfaceName parametern pekar på. Det här värdet måste vara tillräckligt stort för att innehålla gränssnittsnamnet och det avslutande NULL-tecknet. Den maximala tillåtna längden är NDIS_IF_MAX_STRING_SIZE + 1. Mer information om NDIS_IF_MAX_STRING_SIZE finns i avsnittet Kommentarer nedan.
Returvärde
ConvertInterfaceLuidToNameW returnerar STATUS_SUCCESS om funktionen lyckas. Om funktionen misslyckas returnerar ConvertInterfaceLuidToNameW någon av följande felkoder:
| Returnera kod | Beskrivning |
|---|---|
| STATUS_INVALID_PARAMETER | En av parametrarna är ogiltig. ConvertInterfaceLuidToNameW returnerar det här felet om antingen InterfaceLuid eller InterfaceName är NULLeller om InterfaceLuid är ogiltigt. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW returnerar det här felet om bufferten InterfaceName inte var så stor som anges i parametern Length och bufferten därför inte kunde innehålla gränssnittsnamnet. |
Anmärkningar
Funktionen ConvertInterfaceLuidToNameW är protokolloberoende och fungerar med nätverksgränssnitt för både IPv6- och IPv4-protokollen.
Den maximala längden på nätverksgränssnittets namn, NDIS_IF_MAX_STRING_SIZE, utan det avslutande NULL-tecknet, definieras i huvudfilen Ntddndis.h. NDIS_IF_MAX_STRING_SIZE definieras som den IF_MAX_STRING_SIZE konstanten som definieras i ifdef.h-huvudfilen.
Not
Ntddndis.h och Ifdef.h-huvudfiler inkluderas automatiskt i Netioapi.h-huvudfilen. Du bör aldrig använda Ntddndis.h och Ifdef.h huvudfiler direkt.
Använd ConvertInterfaceLuidToNameA för att konvertera ett LUID för nätverksgränssnittet till ett ANSI-gränssnittsnamn.
Krav
Målplattform |
Universell |
Version |
Finns i Windows Vista och senare versioner av Windows-operativsystemen. |
Rubrik |
Netioapi.h (inkludera Netioapi.h) |
Bibliotek |
Netio.lib |
IRQL |
PASSIVE_LEVEL |