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

Функция WifiConfig_GetScannedNetworks

  • Статья

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

Возвращает Wi-Fi сети, обнаруженные последней операцией сканирования. Эта функция не является потокобезопасной.

  • Если scannedNetworkArray размер слишком мал, чтобы вместить все сети, эта функция заполняет все элементы и возвращает количество элементов массива.

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

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

Параметры

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

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

Ошибки

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

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

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

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

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

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

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

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

Возвращает количество WifiConfig_ScannedNetwork элементов, возвращаемых службой scannedNetworkArray, или -1 для сбоя. В этом случае errno устанавливается значение ошибки.

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

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