Partager via

WifiConfig_ForgetNetwork, fonction

  • Article

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

Important

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

Supprime un réseau Wi-Fi de l’appareil. Déconnecte l’appareil du réseau s’il est actuellement connecté. Cette fonction n’est pas thread-safe.

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Paramètres

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.

  • EFAULT : le ssid paramètre est NULL.

  • ENOENT : le storedNetwork paramètre ne correspond à aucun des réseaux stockés.

  • EINVAL : le storedNetwork paramètre ou sa version de struct n’est pas valide.

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