Funktionen ConvertInterfaceAliasToLuid
Funktionen ConvertInterfaceAliasToLuid konverterar ett gränssnittsaliasnamn för ett nätverksgränssnitt 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 ConvertInterfaceAliasToLuid(
_In_ const WCHAR *InterfaceAlias,
_Out_ PNET_LUID InterfaceLuid
);
Parametrar
InterfaceAlias [in]
En pekare till en NULL-avslutad Unicode-sträng som innehåller aliasnamnet för nätverksgränssnittet.InterfaceLuid [out]
En pekare till den NET_LUID unionen för nätverksgränssnittet.
Returvärde
ConvertInterfaceAliasToLuid returnerar STATUS_SUCCESS om funktionen lyckas. Om funktionen misslyckas är parametern InterfaceLuid inställd på NULLoch ConvertInterfaceAliasToLuid returnerar följande felkod:
| Returnera kod | Beskrivning |
|---|---|
| STATUS_INVALID_PARAMETER | En av parametrarna var ogiltig. ConvertInterfaceAliasToLuid returnerar det här felet om antingen InterfaceAlias eller InterfaceLuid är NULLeller om InterfaceAlias är ogiltigt. |
Anmärkningar
Funktionen ConvertInterfaceAliasToLuid är protokolloberoende och fungerar med nätverksgränssnitt för både IPv6- och IPv4-protokollen.
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 |