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

Функция WifiConfig_ForgetNetwork

  • Статья

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

Важно

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

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

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

Параметры

Ошибки

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

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

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

  • ENOENT: storedNetwork параметр не соответствует ни одной из хранимых сетей.

  • EINVAL: недопустимый storedNetwork параметр или его версия структуры.

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

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

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

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

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

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

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

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