Delen via


De functie ConvertInterfaceLuidToGuid

De functie ConvertInterfaceLuidToGuid converteert een lokaal unieke id (LUID) voor een netwerkinterface naar een GUID (Globally Unique Identifier) voor de interface.

Notitie

De ConvertInterfaceXxx API-serie inventariseert id's voor alle interfaces die zijn gebonden aan TCP/IP, waaronder virtuele miniports, lichtgewicht filters, tunneladapters en fysieke interfaces.

Syntaxis

NETIOAPI_API ConvertInterfaceLuidToGuid(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       GUID     *InterfaceGuid
);

Parameters

  • InterfaceLuid [in]
    Een aanwijzer naar een NET_LUID-samenvoeging voor de netwerkinterface.

  • InterfaceGuid [out]
    Een aanwijzer naar de GUID voor de netwerkinterface.

Retourwaarde

ConvertInterfaceLuidToGuid retourneert STATUS_SUCCESS als de functie slaagt. Als de functie mislukt, wordt de parameter InterfaceGuid ingesteld op NULL-en retourneert ConvertInterfaceLuidToGuid de volgende foutcode:

Retourcode Beschrijving
STATUS_INVALID_PARAMETER

Een van de parameters is ongeldig. ConvertInterfaceLuidToGuid retourneert deze fout als InterfaceLuid of InterfaceGuidNULL-is of als InterfaceLuid- ongeldig is.

Opmerkingen

De functie ConvertInterfaceLuidToGuid is protocolonafhankelijk en werkt met netwerkinterfaces voor zowel de IPv6- als IPv4-protocollen.

Eisen

Doelplatform

Universal

Versie

Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.

Rubriek

Netioapi.h (inclusief Netioapi.h)

Bibliotheek

Netio.lib

IRQL

PASSIVE_LEVEL

Zie ook

ConvertInterfaceAliasToLuid-

ConvertInterfaceGuidToLuid-

ConvertInterfaceIndexToLuid-

ConvertInterfaceLuidToAlias-

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA-

ConvertInterfaceLuidToNameW-

ConvertInterfaceNameToLuidA-

ConvertInterfaceNameToLuidW-

NET_LUID