Funktionen ConvertInterfaceNameToLuidA
Funktionen ConvertInterfaceNameToLuidA konverterar ett ANSI-nätverksgränssnittsnamn till den lokalt unika identifieraren (LUID) för gränssnittet.
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 ConvertInterfaceNameToLuidA(
_In_ const CHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parametrar
InterfaceName [in]
En pekare till en NULL-avslutad ANSI-sträng som innehåller nätverksgränssnittets namn.InterfaceLuid [out]
En pekare till den NET_LUID unionen för det här gränssnittet.
Returvärde
ConvertInterfaceNameToLuidA returnerar STATUS_SUCCESS om funktionen lyckas. Om funktionen misslyckas returnerar ConvertInterfaceNameToLuidA någon av följande felkoder:
| Returnera kod | Beskrivning |
|---|---|
| ERROR_BUFFER_OVERFLOW | Längden på ANSI-gränssnittets namn är ogiltigt. ConvertInterfaceNameToLuidA returnerar det här felet om parametern InterfaceName överskrider den maximala tillåtna stränglängden för den här parametern. |
| STATUS_INVALID_NAME | Gränssnittsnamnet är ogiltigt. ConvertInterfaceNameToLuidA returnerar det här felet om parametern InterfaceName innehåller ett ogiltigt gränssnittsnamn. |
| STATUS_INVALID_PARAMETER | En av parametrarna är ogiltig. ConvertInterfaceNameToLuidA returnerar det här felet om parametern InterfaceLuid är NULL. |
Anmärkningar
Funktionen ConvertInterfaceNameToLuidA ä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 avslutande NULL-, definieras i rubrikfilen 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 funktionen ConvertInterfaceNameToLuidW för att konvertera ett Unicode-gränssnittsnamn till ett LUID.
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 |