Compartir vía


Función Networking_SetInterfaceState

Encabezado: #include <applibs/networking.h>

Habilita o deshabilita una interfaz de red.

int Networking_SetInterfaceState(const char *networkInterfaceName, bool isEnabled);

Parámetros

  • networkInterfaceName El nombre de la interfaz de red que se va a actualizar.

  • isEnabled true para habilitar la interfaz, false para deshabilitarla.

Errores

Devuelve -1 si se encuentra un error y se establece errno en el valor de error.

  • EACCES: el manifiesto de la aplicación no incluye la funcionalidad NetworkConfig.

  • ENOENT: la interfaz de red no existe.

  • EPERM: esta función no se permite en la interfaz.

  • EAGAIN: la pila de redes aún no está lista.

  • EIO: la interfaz es inaccesible.

También se pueden especificar otros errno errores; estos errores no son deterministas y es posible que no se conserve el mismo comportamiento a través de las actualizaciones del sistema.

Valor devuelto

Devuelve 0 para éxito o -1 para error, en cuyo caso errno se establece en el valor de error.

Requisitos del manifiesto de la aplicación

El manifiesto de la aplicación debe incluir la funcionalidad NetworkConfig.

Conceptos y ejemplos

Nota

Si Wi-Fi está deshabilitado a través de Networking_SetInterfaceState el subsistema de Wi-Fi estará en modo de "suspensión ligera". Esto también debería apagar las emisiones de RF. Sin embargo, si se le pide que limite las emisiones debido al cumplimiento o a las certificaciones, asegúrese de probar y realizar sus propias mediciones.

En diseños en los que no se requiere Wi-Fi, los componentes front-end de RF se pueden excluir del diseño de hardware. Para obtener más información, consulte Deshabilitar Wi-Fi front-end RF en MT3620.