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

Функция WifiConfig_StoreWpa2Network

  • Статья

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

Важно

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

Хранит Wi-Fi сети WPA2, которая использует предварительно общий ключ. Эта функция не является потокобезопасной.

Примечание

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

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

Параметры

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

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

  • psk Указатель на буфер, содержащий предварительно общий ключ для Wi-Fi сети.

  • pskLength Длина предварительно общего ключа для Wi-Fi сети.

Ошибки

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

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

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

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

  • ERANGE: ssidLength параметр или pskLength равен 0 или больше WIFICONFIG_SSID_MAX_LENGTH и WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.

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

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

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

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

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

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

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

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