Teilen über

WifiConfig_SetTargetedScanEnabled-Funktion

  • Artikel

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, andernfalls false

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.