Windows Dev Center

Expand Minimize

ConvertInterfaceLuidToIndex function

The ConvertInterfaceLuidToIndex 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 [in]

A pointer to a NET_LUID for a network interface.

InterfaceIndex [out]

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 codeMeaning
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 available on Windows Vista and later.

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

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Netioapi.h (include Iphlpapi.h)

Library

Iphlpapi.lib

DLL

Iphlpapi.dll

See also

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

 

 

Community Additions

ADD
Show:
© 2015 Microsoft