Partager via

WifiConfig_SetTargetedScanEnabled, fonction

  • Article

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

Active ou désactive l’analyse ciblée pour un réseau. L’analyse ciblée est désactivée par défaut.

L’analyse ciblée est utilisée pour se connecter à des points d’accès qui ne diffusent pas leur SSID ou qui se trouvent dans un environnement bruyant.

Le paramètre prend effet immédiatement, mais ne persiste pas au redémarrage de l’appareil, sauf si la fonction WifiConfig_PersistConfig est appelée après cette fonction.

Important

L’analyse ciblée fait en sorte que l’appareil transmette des requêtes de sondage susceptibles de révéler le SSID du réseau à d’autres appareils. Elle doit être utilisée uniquement dans les environnements contrôlés, ou sur les réseaux où ce risque est acceptable.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Paramètres

  • networkId ID du réseau que vous souhaitez configurer. Utilisez WifiConfig_AddNetwork pour retourner l’ID réseau d’un réseau nouvellement créé. L’ID réseau est transmis aux fonctions WifiConfig_Set* pour la configuration. Utilisez WifiConfig_SetSSID pour spécifier le SSID à cibler pour l’analyse.

  • enabled true pour activer l’analyse ciblée sur le réseau ; sinon, false.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno 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.

  • EINVAL : le paramètre networkId n’est pas valide.

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

Tout autre errno peut également être spécifié ; 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 retournée

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 d’application doit inclure la fonctionnalité WifiConfig.