WifiConfig_SetNetworkEnabled 函数

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

启用或禁用 Wi-Fi 网络配置。

该设置立即生效,但是除非重启设备后调用 WifiConfig_PersistConfig 函数,否则该设置不会在设备重启后持久保留。

static int WifiConfig_SetNetworkEnabled(int networkId, bool enabled);

参数

  • networkId 要配置的网络的 ID。 WifiConfig_AddNetwork 返回网络 ID。

  • enabled 要启用网络则为 true;否则为 false

错误

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

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

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

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

  • EINVAL:networkId 参数无效。

  • ENODEV:networkId 参数与存储网络的任何 ID 都不匹配。

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

返回值

返回 0 表示成功,如果失败,则返回 -1,在这种情况下 errno 设置为错误值。

应用程序清单要求

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