WifiConfig_SetTargetedScanEnabled, funkcja

Nagłówek: #include <applibs/wificonfig.h>

Włącza lub wyłącza docelowe skanowanie sieci. Skanowanie docelowe jest domyślnie wyłączone.

Skanowanie docelowe służy do łączenia się z punktami dostępu, które nie emitują ich identyfikatora SSID lub znajdują się w hałaśliwym środowisku.

Ustawienie jest skuteczne natychmiast, ale nie będzie utrwalane podczas ponownego uruchamiania urządzenia, chyba że funkcja WifiConfig_PersistConfig zostanie wywołana po tej funkcji.

Ważne

Skanowanie docelowe powoduje, że urządzenie przesyła żądania sondy, które mogą ujawnić identyfikator SSID sieci innym urządzeniom. Powinno to być używane tylko w kontrolowanych środowiskach lub w sieciach, w których jest to akceptowalne ryzyko.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Parametry

• networkId Identyfikator sieci, którą chcesz skonfigurować. Użyj WifiConfig_AddNetwork , aby zwrócić identyfikator sieci nowo utworzonej sieci. Identyfikator sieci jest przekazywany do funkcji WifiConfig_Set* na potrzeby konfiguracji. Użyj WifiConfig_SetSSID , aby określić identyfikator SSID przeznaczony dla skanowania.

• enabledtrue w celu włączenia docelowego skanowania w sieci; w przeciwnym razie . false

Błędy

Zwraca wartość -1, jeśli napotkano błąd i ustawia wartość errno błędu.

• EACCES: manifest aplikacji nie obejmuje funkcji WifiConfig.

• EAGAIN: urządzenie Wi-Fi nie jest gotowe.

• ENETDOWN: interfejs sieciowy sieci Wi-Fi jest niedostępny.

• EINVAL: networkId parametr jest nieprawidłowy.

• ENODEV: networkId parametr nie jest zgodny z żadną z przechowywanych sieci.

errno Inne mogą być również określone. Takie błędy nie są deterministyczne, a takie samo zachowanie może nie być zachowywane za pośrednictwem aktualizacji systemu.

Wartość zwracana

Zwraca wartość 0 dla powodzenia lub -1 dla niepowodzenia, w tym przypadku errno jest ustawiona wartość błędu.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję WifiConfig.