WifiConfig_SetTargetedScanEnabled, fonction
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.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
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.