Compartir vía

Función WifiConfig_StoreWpa2Network

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Importante

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

Almacena una red WPA2 Wi-Fi que usa una clave previamente compartida. Esta función no es segura para subprocesos.

Nota

Esta función producirá un error si una red con el mismo SSID y una clave previamente compartida ya está almacenada. Vea la sección de error (EEXIST).

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

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.

  • psk Puntero a un búfer que contiene la clave previamente compartida de la red Wi-Fi.

  • pskLength La longitud de la clave previamente compartida 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: ya existe una red de Wi-Fi almacenada que tiene el mismo SSID y usa WPA2.

  • EFAULT: o ssidpsk es NULL.

  • ERANGE: el ssidLength parámetro o pskLength es 0 o mayor que WIFICONFIG_SSID_MAX_LENGTH y WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

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