Partage via

WifiConfig_StoreWpa2Network, fonction

  • Article

En-tête : #include <applibs/wificonfig.h>

Important

Cette fonction est obsolète. Utilisez WifiConfig_AddNetwork à la place.

Stocke un réseau wpa2 Wi-Fi qui utilise une clé pré-partagée. Cette fonction n’est pas thread-safe.

Note

Cette fonction échoue si un réseau avec le même SSID et la même clé pré-partagée est déjà stocké. Consultez la section d’erreur (EEXIST).

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

Paramètres

  • ssid Pointeur vers un tableau d’octets SSID avec un encodage de caractères non spécifié qui identifie le réseau Wi-Fi.

  • ssidLength Nombre d’octets dans le SSID du réseau Wi-Fi.

  • psk Pointeur vers une mémoire tampon qui contient la clé pré-partagée pour le réseau Wi-Fi.

  • pskLength Longueur de la clé pré-partagée pour le réseau Wi-Fi.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EACCES : le manifeste de l’application n’inclut pas la fonctionnalité WifiConfig.

  • EEXIST : il existe déjà un réseau Wi-Fi stocké qui a le même SSID et utilise WPA2.

  • EFAULT : ou psk a la ssid valeur NULL.

  • ERANGE : le ssidLength paramètre ou pskLength est égal à 0 ou supérieur à WIFICONFIG_SSID_MAX_LENGTH et WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

  • EAGAIN : l’appareil Wi-Fi n’est pas encore prêt.

  • ENETDOWN : l’interface réseau Wi-Fi n’est pas disponible.

  • ENOSPC : il y a trop de réseaux Wi-Fi pour que la configuration soit conservée; supprimez-en un et réessayez.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des mises à jour système.

Valeur de retour

Retourne 0 pour la réussite, ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur.

Exigences du manifeste d’application

Le manifeste de l’application doit inclure la fonctionnalité WifiConfig.