ConvertInterfaceLuidToGuid function (netioapi.h)

Article
02/22/2024

The ConvertInterfaceLuidToGuid function converts a locally unique identifier (LUID) for a network interface to a globally unique identifier (GUID) for the interface.

Syntax

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceLuidToGuid(
  [in]  const NET_LUID *InterfaceLuid,
  [out] GUID           *InterfaceGuid
);

Parameters

[in] InterfaceLuid

A pointer to a NET_LUID for a network interface.

[out] InterfaceGuid

A pointer to the GUID for this interface.

Return value

On success, ConvertInterfaceLuidToGuid returns NO_ERROR. Any nonzero return value indicates failure and a NULL is returned in the InterfaceGuid parameter.

Error code	Meaning
ERROR_INVALID_PARAMETER	One of the parameters was invalid. This error is returned if either the InterfaceLuid or InterfaceGuid parameter was NULL or if the InterfaceLuid parameter was invalid.

Remarks

The ConvertInterfaceLuidToGuid function is available on Windows Vista and later.

The ConvertInterfaceLuidToGuid function is protocol independent and works with network interfaces for both the IPv6 and IPv4 protocol.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	netioapi.h (include Iphlpapi.h)
Library	Iphlpapi.lib
DLL	Iphlpapi.dll