Función if_nametoindex (netioapi.h)
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 |