WifiConfig_SetTargetedScanEnabled-Funktion
Header: #include <applibs/wificonfig.h>
Aktiviert oder deaktiviert die gezielte Überprüfung auf ein Netzwerk. Gezielte Überprüfung ist standardmäßig deaktiviert.
Gezielte Überprüfung wird verwendet, um eine Verbindung mit Zugriffspunkten herzustellen, die Ihre SSID nicht übertragen oder sich in einer überlasteten Umgebung befinden.
Die Einstellung wird sofort wirksam, bleibt aber bei einem Geräteneustart nicht erhalten, es sei denn, die Funktion WifiConfig_PersistConfig wird nach dieser Funktion aufgerufen.
Wichtig
Gezielte Überprüfung bewirkt, dass das Gerät Testanforderungen übermittelt, die möglicherweise die SSID des Netzwerks für andere Geräte offenlegen. Dies sollte nur in kontrollierten Umgebungen oder in Netzwerken verwendet werden, in denen dies ein akzeptables Risiko darstellt.
static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);
Parameter
networkId
Die ID des Netzwerks, das Sie konfigurieren möchten. Verwenden Sie WifiConfig_AddNetwork , um die Netzwerk-ID eines neu erstellten Netzwerks zurückzugeben. Die Netzwerk-ID wird an WifiConfig_Set* -Funktionen für die Konfiguration übergeben. Verwenden Sie WifiConfig_SetSSID , um die SSID für die Überprüfung anzugeben.enabled
:true
, um die gezielte Überprüfung im Netzwerk zu aktivieren, andernfallsfalse
Fehler
Gibt -1 zurück, wenn ein Fehler auftritt und auf den Fehlerwert festgelegt errno
wird.
EACCES: Das Anwendungsmanifest enthält nicht die WifiConfig-Funktion.
EAGAIN: Das WLAN-Gerät ist nicht bereit.
ENETDOWN: Die WLAN-Netzwerkschnittstelle ist nicht verfügbar.
EINVAL: Der Parameter
networkId
ist ungültig.ENODEV: Der
networkId
Parameter stimmt nicht mit einem der gespeicherten Netzwerke überein.
Alle anderen errno
können auch angegeben werden; solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht über Systemupdates beibehalten.
Rückgabewert
Gibt 0 für Erfolg oder -1 für Fehler zurück, in diesem Fall errno
wird auf den Fehlerwert festgelegt.
Anforderungen für das Anwendungsmanifest
Das Anwendungsmanifest muss die Funktion „WifiConfig“ enthalten.