WifiConfig_StoreOpenNetwork, fonction
En-tête : #include <applibs/wificonfig.h>
Important
Cette fonction est obsolète. Utilisez WifiConfig_AddNetwork à la place.
Stocke un réseau Wi-Fi ouvert sans clé. Cette fonction n’est pas thread-safe.
Cette fonction échoue si un réseau identique est déjà stocké sur l’appareil sans clé. Consultez la section d’erreur (EEXIST). Toutefois, si un réseau stocké inclut une clé avec le même SSID, cette fonction réussit et stocke le réseau.
int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);
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.
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 : un réseau Wi-Fi stocké qui a le même SSID et n’existe déjà aucune clé.
EFAULT : a la
ssid
valeur NULL.ERANGE : est
ssidLength
égal à 0 ou supérieur à WIFICONFIG_SSID_MAX_LENGTH.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.
Retourne 0 pour la réussite, ou -1 en cas d’échec, auquel cas errno
est défini sur la valeur d’erreur.
Le manifeste de l’application doit inclure la fonctionnalité WifiConfig.