WifiConfig_SetTargetedScanEnabled-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Aktiviert oder deaktiviert die gezielte Überprüfung für ein Netzwerk. Die gezielte Überprüfung ist standardmäßig deaktiviert.

Die gezielte Überprüfung wird verwendet, um eine Verbindung mit Zugriffspunkten herzustellen, die ihre SSID nicht übertragen oder sich in einer lauten Umgebung befinden.

Die Einstellung wird sofort wirksam, wird aber nicht über Geräteneustarts hinweg beibehalten, es sei denn, die WifiConfig_PersistConfig Funktion wird nach dieser Funktion aufgerufen.

Wichtig

Die gezielte Überprüfung bewirkt, dass das Gerät Testanforderungen überträgt, die die SSID des Netzwerks an andere Geräte anzeigen können. 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 zur Konfiguration an WifiConfig_Set* -Funktionen übergeben. Verwenden Sie WifiConfig_SetSSID , um die SSID für die Überprüfung anzugeben.

  • enabledtrue um gezieltes Scannen im Netzwerk zu ermöglichen; falseandernfalls .

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

  • EACCES: Das Anwendungsmanifest enthält die WifiConfig-Funktion nicht.

  • EAGAIN: Das Wi-Fi Gerät ist nicht bereit.

  • ENETDOWN: Die Wi-Fi Netzwerkschnittstelle ist nicht verfügbar.

  • EINVAL: Der networkId Parameter ist ungültig.

  • ENODEV: Der networkId Parameter stimmt mit keinem der gespeicherten Netzwerke überein.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch 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 an das Anwendungsmanifest

Das Anwendungsmanifest muss die WifiConfig-Funktion enthalten.