Бөлісу құралы:

Функция WifiConfig_SetConfigName

  • Мақала

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

Задает имя конфигурации сети. Имя можно использовать в качестве удобного дескриптора для идентификации конфигурации сети. Настоятельно рекомендуется, чтобы это имя было уникальным.

Параметр вступает в силу немедленно, но не будет сохраняться при перезагрузке устройства, если после нее не будет вызвана функция WifiConfig_PersistConfig .

static int WifiConfig_SetConfigName(int networkId, const char *configName);

Параметры

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

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

Ошибки

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

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

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

  • ERANGE: configName параметр больше WIFICONFIG_CONFIG_NAME_MAX_LENGTH.

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

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

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

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

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

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

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

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

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