if_indextoname (Compact 2013)

3/26/2014

This function converts the local index for a network interface to the ANSI interface name.

Syntax

PCHAR WINAPI if_indextoname(
  __in   NET_IFINDEX InterfaceIndex,
  __out  PCHAR InterfaceName
);

Parameters

  • InterfaceIndex
    The local index for a network interface.
  • InterfaceName
    A pointer to a buffer to hold the NULL-terminated ANSI string that contains the interface name when the function returns successfully. The length, in bytes, of the buffer pointed to by this parameter must be equal to or greater than IF_NAMESIZE.

Return Value

On success, if_indextoname returns a pointer to NULL-terminated ANSI string that contains the interface name. On failure, a NULL pointer is returned.

Remarks

The if_indextoname function maps an interface index into its corresponding name. This function is designed as part of basic socket extensions for IPv6 as described by the IETF in RFC 2553.

The if_indextoname function is implemented for portability of applications that have Unix environments, but the ConvertInterface functions are preferred. The if_indextoname function can be replaced by a call to the ConvertInterfaceIndexToLuid function to convert an interface index to a NET_LUID followed by a call to the ConvertInterfaceLuidToNameA to convert the NET_LUID to the ANSI interface name.

If the if_indextoname fails and returns a NULL pointer, you cannot determine an error code.

The length, in bytes, of the buffer pointed to by the InterfaceName parameter must be equal or greater than IF_NAMESIZE, a value declared in the Netioapi.h header file equal to NDIS_IF_MAX_STRING_SIZE. The maximum length of an interface name, NDIS_IF_MAX_STRING_SIZE, without the terminating NULL is declared in the Ntddndis.h header file. The NDIS_IF_MAX_STRING_SIZE is defined to be the IF_MAX_STRING_SIZE constant defined in the Ifdef.h header file. The Ntddndis.h and Ifdef.h header files are automatically included in the Netioapi.h header file which is automatically included by the Iphlpapi.h header file. The Ntddndis.h, Ifdef.h, and Netioapi.h header files should never be used directly.

See Also

Reference

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