Partage 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 aux points d’accès qui ne diffusent pas leur SSID ou qui se trouvent dans un environnement bruyant.

Le paramètre est effectif immédiatement, mais ne sera pas conservé sur les redémarrages de l’appareil, sauf si la fonction WifiConfig_PersistConfig est appelée après cette fonction.

Important

L’analyse ciblée amène l’appareil à transmettre des requêtes de sonde qui peuvent révéler le SSID du réseau à d’autres appareils. Il ne doit être utilisé que dans des environnements contrôlés ou sur des 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 passé aux fonctions WifiConfig_Set* pour la configuration. Utilisez WifiConfig_SetSSID pour spécifier le SSID à cibler pour l’analyse.

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

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

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

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.