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

Функция WifiConfig_StoreOpenNetwork

  • Статья

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

Важно

Эта функция устарела. Вместо этого используйте WifiConfig_AddNetwork .

Сохраняет открытую сеть Wi-Fi без ключа. Эта функция не является потокобезопасной.

Эта функция завершится ошибкой, если на устройстве уже хранится идентичная сеть без ключа. См. раздел об ошибке (EEXIST). Однако если хранимая сеть содержит ключ вместе с тем же идентификатором SSID, эта функция будет успешно выполнена и сохранит сеть.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

Параметры

  • ssid Указатель на массив байтов SSID с неуказанным кодировкой символов, который идентифицирует Wi-Fi сети.

  • ssidLength Количество байтов в SSID Wi-Fi сети.

Ошибки

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

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

  • EEXIST: хранимая сеть Wi-Fi, которая имеет тот же SSID и ключ уже не существует.

  • EFAULT: имеет ssid значение NULL.

  • ERANGE: ssidLength значение равно 0 или больше WIFICONFIG_SSID_MAX_LENGTH.

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

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

  • ENOSPC: существует слишком много Wi-Fi сетей для сохранения конфигурации; удалите один и повторите попытку.

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

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

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

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

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