if_nametoindex función
La función if_nametoindex convierte el nombre de interfaz ANSI de una interfaz de red en el índice local de la interfaz.
Sintaxis
NET_IFINDEX NETIOAPI_API_ if_nametoindex(
_In_ PCSTR InterfaceName
);
Parámetros
- InterfaceName [in]
Puntero a una cadena ANSI terminada en NULL que contiene el nombre de la interfaz.
Valor devuelto
Si la función se realiza correctamente, if_nametoindex devuelve el índice de interfaz local. Si se produce un error en la función, if_nametoindex devuelve cero.
Observaciones
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 como se describe en IETF en RFC 2553.
La función if_nametoindex se implementa para la portabilidad de controladores con entornos Unix, pero las funciones ConvertInterfaceXxx son el método preferido para convertir identificadores de interfaz de red. Puede reemplazar la función if_nametoindex por una llamada a la función ConvertInterfaceNameToLuidA para convertir el nombre de la interfaz ANSI en una unión de NET_LUID , seguida de una llamada a la función ConvertInterfaceLuidToIndex para convertir NET_LUID en el índice de interfaz local.
Si se produce un error en la función if_nametoindex y devuelve cero, no se puede determinar un código de error.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |