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

Функция WifiConfig_GetStoredNetworks

  • Статья

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

Извлекает все сохраненные Wi-Fi сети на устройстве. Эта функция не является потокобезопасной.

Примечание

Перед вызовом WifiConfig_GetStoredNetworks необходимо вызвать WifiConfig_GetStoredNetworkCount и использовать результат в качестве размера массива WifiConfig_StoredNetwork , передаваемого storedNetworkArray в качестве параметра.

  • Если storedNetworkArray размер слишком мал для хранения всех сохраненных Wi-Fi сетей, эта функция заполняет массив и возвращает количество элементов массива.

  • Если возможность WiFiConfig отсутствует, функция возвращает пустой массив.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

Параметры

  • storedNetworkArray Указатель на массив, возвращающий сохраненные Wi-Fi сети.

  • storedNetworkArrayCount Количество элементов storedNetworkArray , которые могут храниться. Массив должен содержать по одному элементу для каждой хранимой Wi-Fi сети.

Ошибки

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

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

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

  • ERANGE: storedNetworkArrayCount параметр равен 0.

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

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

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

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

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

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

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