Функция WifiConfig_GetNetworkIdByConfigName

  • Статья

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

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

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Параметры

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

Ошибки

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

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

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

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

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

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

  • ENODEV: не удается найти указанную конфигурацию сети.

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

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

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

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

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