Funktionen ConvertInterfaceGuidToLuid
Funktionen ConvertInterfaceGuidToLuid konverterar en globalt unik identifierare (GUID) 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 ConvertInterfaceGuidToLuid(
_In_ const GUID *InterfaceGuid,
_Out_ PNET_LUID InterfaceLuid
);
Parametrar
InterfaceGuid [in]
En pekare till ett GUID för nätverksgränssnittet.InterfaceLuid [out]
En pekare till den NET_LUID unionen för nätverksgränssnittet.
Returvärde
ConvertInterfaceGuidToLuid returnerar STATUS_SUCCESS om funktionen lyckas. Om funktionen misslyckas är parametern InterfaceLuid inställd på NULLoch ConvertInterfaceGuidToLuid returnerar följande felkod:
| Returnera kod | Beskrivning |
|---|---|
| STATUS_INVALID_PARAMETER | En av parametrarna var ogiltig. ConvertInterfaceGuidToLuid returnerar det här felet om antingen InterfaceAlias eller InterfaceLuid är NULLeller om InterfaceGuid är ogiltigt. |
Anmärkningar
Funktionen ConvertInterfaceGuidToLuid ä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 |