Функция WifiConfig_SetTargetedScanEnabled

  • Статья

Заголовок: #include <applibs/wificonfig.h>

Включает или отключает целевое сканирование сети. Целевое сканирование по умолчанию отключено.

Целевое сканирование используется для подключения к точкам доступа, которые не транслируют свой SSID или находятся в шумной среде.

Параметр вступает в силу немедленно, но не будет сохраняться при перезагрузке устройства, если после нее не будет вызвана функция WifiConfig_PersistConfig .

Важно

Целевое сканирование заставляет устройство передавать запросы пробы, которые могут показать SSID сети на другие устройства. Это следует использовать только в управляемых средах или в сетях, где это допустимый риск.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

Параметры

  • networkId Идентификатор сети, которую требуется настроить. Используйте WifiConfig_AddNetwork для возврата сетевого идентификатора только что созданной сети. Идентификатор сети передается функциям WifiConfig_Set* для настройки. Используйте WifiConfig_SetSSID , чтобы указать SSID для целевого сканирования.

  • enabledtrue для включения целевого сканирования в сети; В противном случае — falseзначение .

Ошибки

Возвращает значение -1 при обнаружении ошибки и задает errno значение ошибки.

  • EACCES: манифест приложения не включает возможность WifiConfig.

  • EAGAIN: Wi-Fi устройство не готово.

  • ENETDOWN: сетевой интерфейс Wi-Fi недоступен.

  • EINVAL: networkId параметр недопустим.

  • ENODEV: networkId параметр не соответствует ни одной из хранимых сетей.

Можно также указать любой другой errno . Такие ошибки не являются детерминированными, и такое же поведение может не сохраняться при обновлении системы.

Возвращаемое значение

Возвращает значение 0 для успешного выполнения или -1 для сбоя. В этом случае errno задается значение ошибки.

Требования к манифесту приложения

Манифест приложения должен включать возможность WifiConfig.