ConvertInterfaceGuidToLuid (NETIOAPI) (Compact 2013)

  • Article

3/26/2014

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

Syntax

NETIOAPI_API
  ConvertInterfaceGuidToLuid(
    IN const GUID*  InterfaceGuid,
    OUT PNET_LUID  InterfaceLuid
    );

Parameters

  • InterfaceGuid
    A pointer to a GUID for the network interface.
  • InterfaceLuid
    A pointer to the NET_LUID structure for the network interface.

Return Value

ConvertInterfaceGuidToLuid returns STATUS_SUCCESS if the function succeeds. If the function fails, the InterfaceLuid parameter is set to NULL, and ConvertInterfaceGuidToLuid returns the following error code:

Error Code

Meaning

STATUS_INVALID_PARAMETER

One of the parameters was invalid. ConvertInterfaceGuidToLuid returns this error if either InterfaceAlias or InterfaceLuid is NULL, or if InterfaceGuid is invalid.

Remarks

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

See Also

Reference

IP Helper Kernel-Mode Functions
ConvertInterfaceAliasToLuid (NETIOAPI)
ConvertInterfaceIndexToLuid (NETIOAPI)
ConvertInterfaceLuidToGuid (NETIOAPI)
ConvertInterfaceLuidToIndex (NETIOAPI)
ConvertInterfaceLuidToNameA (NETIOAPI)
ConvertInterfaceLuidToNameW (NETIOAPI)
ConvertInterfaceNameToLuidA (NETIOAPI)
ConvertInterfaceNameToLuidW (NETIOAPI)
NET_LUID