Функция WifiConfig_AddNetwork

  • Статья

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

Добавляет Wi-Fi сеть на устройство и возвращает идентификатор сети.

int WifiConfig_AddNetwork(void);

Ошибки

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

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

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

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

  • ENOMEM: недостаточно памяти для добавления новой сети.

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

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

Возвращает идентификатор новой сети или значение -1 для сбоя. В этом случае errno задается значение ошибки. Идентификатор сети равен нулю или положительному значению.

Замечания

Идентификатор сети передается функциям WifiConfig_Set* , например WifiConfig_SetSSID.

Новая сеть не настроена и может быть настроена с помощью функций WifiConfig_Set* . Изменения в конфигурации сети вступает в силу немедленно, но теряются при перезагрузке устройства, если только функция WifiConfig_PersistConfig не вызывается для сохранения конфигурации в неизменяемом хранилище.

Количество сетей, которые можно хранить на устройстве, не является фиксированным, но зависит от доступных ресурсов и объема хранилища, необходимого для каждой конфигурации сети.

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

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