ConvertInterfaceLuidToIndex (Compact 2013)

3/26/2014

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

Syntax

NETIO_STATUS WINAPI ConvertInterfaceLuidToIndex(
  __in   const NET_LUID* InterfaceLuid,
  __out  PNET_IFINDEX InterfaceIndex
);

Parameters

  • InterfaceLuid
    A pointer to a NET_LUID for a network interface.
  • InterfaceIndex
    The local index value for the interface.

Return Value

On success, ConvertInterfaceLuidToIndex returns NO_ERROR. Any nonzero return value indicates failure and a NET_IFINDEX_UNSPECIFIED is returned in the InterfaceIndex parameter.

Error code

Meaning

ERROR_INVALID_PARAMETER

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

Remarks

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

See Also

Reference

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