Share via

ConvertInterfaceIndexToLuid (NETIOAPI) (Compact 7)

  • Article

3/12/2014

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

Syntax

NETIOAPI_API
  ConvertInterfaceIndexToLuid(
    IN NET_IFINDEX  InterfaceIndex,
    OUT PNET_LUID  InterfaceLuid
    );

Parameters

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

Return Value

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

Error Code Meaning

STATUS_INVALID_PARAMETER

One of the parameters was invalid. ConvertInterfaceIndexToLuid returns this error if the InterfaceLuid parameter is NULL, or if the InterfaceIndex parameter is invalid.

Remarks

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