Compartir a través de

Función WifiConfig_ForgetNetwork

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Importante

Esta función está obsoleta. Use WifiConfig_ForgetNetworkById en su lugar.

Quita una red Wi-Fi del dispositivo. Desconecta el dispositivo de la red si está conectado actualmente. Esta función no es segura para subprocesos.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Parámetros

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 WifiConfig.

  • EFAULT: el ssid parámetro es NULL.

  • ENOENT: el storedNetwork parámetro no coincide con ninguna de las redes almacenadas.

  • EINVAL: el storedNetwork parámetro o su versión struct no es válida.

  • EAGAIN: el dispositivo Wi-Fi aún no está listo.

  • ENETDOWN: la interfaz de red Wi-Fi no está disponible.

  • ENOSPC: hay demasiadas redes de Wi-Fi para que la configuración persista; quitar uno y volver a intentarlo.

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 WifiConfig.