Partager via

WifiConfig_StoreOpenNetwork, fonction

  • Article

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);

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.

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

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.