Функция WifiConfig_AddDuplicateNetwork

  • Статья

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

Добавляет новую сеть, которая является дубликатом указанной сети с указанным идентификатором. Новой сети присваивается указанное имя и по умолчанию она отключена.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

Параметры

  • networkId Идентификатор сети для дублирования. WifiConfig_AddNetwork возвращает идентификатор сети.

  • configName Указатель на массив байтов, содержащий имя конфигурации. Массив должен быть завершен в формате NULL и не более WIFICONFIG_CONFIG_NAME_MAX_LENGTH байтов, за исключением символа завершения.

Ошибки

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

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

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

  • EEXIST: configName не является уникальным.

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

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

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

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

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

  • ERANGE: содержит менее одного символа configName или более WIFICONFIG_CONFIG_NAME_MAX_LENGTH символов.

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

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

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

Замечания

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

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

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

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