Поделиться через

Функция 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 для целевого объекта сканирования.

  • enabled true, чтобы включить целевое сканирование в сети; в противном случае false.

ошибки

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

  • EACCES: манифест приложения не содержит функцию WifiConfig.

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

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

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

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

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

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

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

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

В манифесте приложения должна быть включена функция WifiConfig.