WifiConfig_GetStoredNetworkCount 函数

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

获取设备上存储 Wi-Fi 网络的数量。 此函数不是线程安全的。

注意

在调用 WifiConfig_GetStoredNetworks之前,必须调用 WifiConfig_GetStoredNetworkCount 并将结果用作传递给 WifiConfig_GetStoredNetworks 的WifiConfig_StoredNetwork 数组的数组大小。

ssize_t WifiConfig_GetStoredNetworkCount(void);

错误

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

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

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

  • ENETDOWN:Wi-Fi 网络接口不可用。

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

返回值

返回设备上存储的 Wi-Fi 网络数,如果失败,则返回 -1,在这种情况下 errno ,将 设置为错误值。

应用程序清单要求

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