Compartir vía

Función WifiConfig_SetPSK

  • Artículo

Encabezado: #include <applibs/wificonfig.h>

Establece la clave previamente compartida (PSK) de una red Wi-Fi. El PSK se usa para las redes que están configuradas con el tipo de WifiConfig_Security_Wpa2_Psk seguridad.

La configuración se aplica inmediatamente, pero no se conservará en todos los reinicios del dispositivo, a menos que se llame a la función WifiConfig_PersistConfig después de esta función.

static int WifiConfig_SetPSK(int networkId, const char *psk, size_t pskLength);

Parámetros

  • networkId El id. de la red que se va a configurar. WifiConfig_AddNetwork devuelve el id. de red.

  • psk Puntero al búfer que contiene el PSK de la red.

  • pskLength La longitud del PSK de la red. Este parámetro debe ser menor o igual que WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

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 psk parámetro es NULL.

  • ERANGE: el pskLength parámetro es mayor que WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

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

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

  • EINVAL: el networkId parámetro no es válido.

  • ENODEV: el networkId parámetro no coincide con ninguno de los identificadores de las redes almacenadas.

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.