通过

WifiConfig_GetScannedNetworks 函数

  • 项目

标头： #include <applibs/wificonfig.h>

获取上次扫描操作找到的 Wi-Fi 网络。 此函数不是线程安全的。

  • 如果 scannedNetworkArray 太小而无法容纳所有网络，则此函数将填充所有元素并返回数组元素的数目。

  • 如果 WiFiConfig 功能不存在，则函数将返回一个空数组。

ssize_t WifiConfig_GetScannedNetworks(WifiConfig_ScannedNetwork * scannedNetworkArray, size_t scannedNetworkArrayCount);

参数

  • scannedNetworkArray 指向返回检索到 Wi-Fi 网络的数组的指针。

  • scannedNetworkArrayCount scannedNetworkArray 可以容纳的元素数。 对于上次扫描操作找到的每个 Wi-Fi 网络，数组应有一个元素。

错误

如果遇到错误并设置为 errno 错误值，则返回 -1。

  • EACCES：应用程序清单不包括 WifiConfig 功能。

  • EFAULT： scannedNetworkArray 参数为 NULL。

  • ERANGE： scannedNetworkArrayCount 参数为 0。

  • EINVAL： scannedNetworkArray 参数或其结构版本无效。

  • EAGAIN：Wi-Fi 设备尚未准备就绪。

还可以指定任何其他 errno 错误;此类错误不是确定性的，并且可能不会通过系统更新保留相同的行为。

返回值

返回 scannedNetworkArray 返回的 WifiConfig_ScannedNetwork 元素数，如果失败，则返回 -1，在这种情况下 errno ，将 设置为错误值。

应用程序清单要求

应用程序清单必须包含 WifiConfig 功能。