Funktionen ConvertInterfaceLuidToGuid

Artikel
2025-03-13

Funktionen ConvertInterfaceLuidToGuid konverterar en lokalt unik identifierare (LUID) för ett nätverksgränssnitt till en globalt unik identifierare (GUID) för gränssnittet.

Anteckning

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 ConvertInterfaceLuidToGuid(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       GUID     *InterfaceGuid
);

Parametrar

InterfaceLuid [in]
En pekare till en NET_LUID union för nätverksgränssnittet.
InterfaceGuid [ut]
En pekare till GUID för nätverksgränssnittet.

Returvärde

ConvertInterfaceLuidToGuid returnerar STATUS_SUCCESS om funktionen lyckas. Om funktionen misslyckas är parametern InterfaceGuid inställd på NULLoch ConvertInterfaceLuidToGuid returnerar följande felkod:

Returnera kod	Beskrivning
STATUS_INVALID_PARAMETER	En av parametrarna är ogiltig. ConvertInterfaceLuidToGuid returnerar det här felet om antingen InterfaceLuid eller InterfaceGuid är NULL, eller om InterfaceLuid är ogiltigt.

Anmärkningar

Funktionen ConvertInterfaceLuidToGuid ä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