ConvertInterfaceLuidToIndex (NETIOAPI) (Compact 2013)

  • Article

3/26/2014

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

Syntax

NETIOAPI_API
  ConvertInterfaceLuidToIndex(
    IN const NET_LUID*  InterfaceLuid,
    OUT PNET_IFINDEX  InterfaceIndex
    );

Parameters

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

Return Value

ConvertInterfaceLuidToIndex returns STATUS_SUCCESS if the function succeeds. If the function fails, the InterfaceIndex parameter is set to NET_IFINDEX_UNSPECIFIED, and ConvertInterfaceLuidToIndex returns the following error code:

Error Code

Meaning

STATUS_INVALID_PARAMETER

One of the parameters is invalid. ConvertInterfaceLuidToIndex returns this error if either InterfaceLuid or InterfaceIndex is NULL, or if InterfaceLuid is invalid.

Remarks

The ConvertInterfaceLuidToIndex 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)
ConvertInterfaceGuidToLuid (NETIOAPI)
ConvertInterfaceIndexToLuid (NETIOAPI)
ConvertInterfaceLuidToGuid (NETIOAPI)
ConvertInterfaceLuidToNameA (NETIOAPI)
ConvertInterfaceLuidToNameW (NETIOAPI)
ConvertInterfaceNameToLuidA (NETIOAPI)
ConvertInterfaceNameToLuidW (NETIOAPI)
NET_LUID