Partager via

WifiConfig_AddNetwork, fonction

  • Article

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

Ajoute un réseau Wi-Fi à l’appareil et retourne l’ID du réseau.

int WifiConfig_AddNetwork(void);

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.

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

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

  • ENOMEM : mémoire insuffisante pour ajouter un nouveau réseau.

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 l’ID du nouveau réseau, ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur. L’ID réseau est zéro ou une valeur positive.

Remarques

L’ID réseau est transmis aux fonctions WifiConfig_Set* , telles que WifiConfig_SetSSID.

Le nouveau réseau n’est pas configuré et peut être configuré avec les fonctions WifiConfig_Set* . Les modifications apportées à la configuration réseau prennent effet immédiatement, mais elles sont perdues lorsque l’appareil redémarre, sauf si la fonction WifiConfig_PersistConfig est appelée pour enregistrer la configuration dans un stockage non volatile.

Le nombre de réseaux que vous pouvez stocker sur un appareil n’est pas fixe, mais dépend des ressources disponibles et de la quantité de stockage nécessaire pour chaque configuration réseau.

Exigences du manifeste d’application

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