Compartir vía

Función WifiConfig_StoreOpenNetwork

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Importante

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

Almacena una red Wi-Fi abierta sin una clave. Esta función no es segura para subprocesos.

Esta función producirá un error si una red idéntica ya está almacenada en el dispositivo sin una clave. Vea la sección de error (EEXIST). Sin embargo, si una red almacenada incluye una clave junto con el mismo SSID, esta función se completará correctamente y almacenará la red.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

Parámetros

  • ssid Puntero a una matriz de bytes SSID con codificación de caracteres no especificados que identifica el Wi-Fi red.

  • ssidLength El número de bytes en el SSID de la red Wi-Fi.

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.

  • EEXIST: una red Wi-Fi almacenada que tiene el mismo SSID y no existe ninguna clave.

  • EFAULT: el ssid es NULL.

  • ERANGE: es ssidLength 0 o mayor que WIFICONFIG_SSID_MAX_LENGTH.

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