Share via

ConvertInterfaceAliasToLuid (Compact 7)

  • Article

3/12/2014

This function converts an interface alias name for a network interface to the locally unique identifier (LUID) for the interface.

Syntax

NETIO_STATUS WINAPI ConvertInterfaceAliasToLuid(
  __in   const WCHAR* InterfaceAlias,
  __out  PNET_LUID InterfaceLuid
);

Parameters

  • InterfaceAlias
    A pointer to a NULL-terminated Unicode string that contains the alias name of the network interface.
  • InterfaceLuid
    A pointer to the NET_LUID for this interface.

Return Value

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

Error code Meaning

ERROR_INVALID_PARAMETER

One of the parameters was invalid. This error is returned if either the InterfaceAlias or InterfaceLuid parameter was NULL or if the InterfaceAlias parameter was invalid.

Remarks

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

See Also

Reference

IP Helper Functions
ConvertInterfaceGuidToLuid
ConvertInterfaceIndexToLuid
ConvertInterfaceLuidToAlias
ConvertInterfaceLuidToGuid
ConvertInterfaceLuidToIndex
ConvertInterfaceLuidToNameA
ConvertInterfaceLuidToNameW
ConvertInterfaceNameToLuidA
ConvertInterfaceNameToLuidW
if_indextoname
if_nametoindex
NET_LUID