Función if_nametoindex (netioapi.h)

Artículo
03/09/2024

La función if_nametoindex convierte el nombre de interfaz ANSI de una interfaz de red en el índice local de la interfaz.

Sintaxis

IPHLPAPI_DLL_LINKAGE NET_IFINDEX NETIOAPI_API_ if_nametoindex(
  [in] PCSTR InterfaceName
);

Parámetros

[in] InterfaceName

Puntero a una cadena ANSI terminada en NULL que contiene el nombre de la interfaz.

Valor devuelto

Si se ejecuta correctamente, if_nametoindex devuelve el índice de interfaz local. Si se produce un error, se devuelve cero.

Comentarios

La función if_nametoindex está disponible en Windows Vista y versiones posteriores.

La función if_nametoindex asigna un nombre de interfaz a su índice correspondiente. Esta función está diseñada como parte de las extensiones de socket básicas para IPv6, tal y como se describe en IETF en RFC 2553. Para obtener más información, vea http://www.ietf.org/rfc/rfc2553.txt.

La función if_nametoindex se implementa para la portabilidad de aplicaciones con entornos Unix, pero se prefieren las funciones ConvertInterface. La función if_nametoindex se puede reemplazar por una llamada a la función ConvertInterfaceNameToLuidA para convertir el nombre de la interfaz ANSI en un NET_LUID seguido de una llamada a ConvertInterfaceLuidToIndex para convertir el NET_LUID en el índice de la interfaz local.

Si se produce un error en la función if_nametoindex y devuelve cero, no es posible determinar un código de error.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	netioapi.h (include Iphlpapi.h)
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll