Networking_SetInterfaceState 函数

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

启用或禁用网络接口。

int Networking_SetInterfaceState(const char *networkInterfaceName, bool isEnabled);

参数

  • networkInterfaceName 要更新的网络接口的名称。

  • isEnabled 如果为 true,则启用接口,如果为 false,则禁用接口。

错误

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

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

  • ENOENT:网络接口不存在。

  • EPERM:接口上不允许使用此函数。

  • EAGAIN:网络堆栈尚未准备就绪。

  • EIO:接口不可访问。

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

返回值

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

应用程序清单要求

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

概念和示例

注意

如果通过Networking_SetInterfaceState禁用 Wi-Fi,Wi-Fi 子系统将处于“浅睡眠”模式。 这还应关闭 RF 发射。 但是,如果由于合规性或认证而要求限制排放,请确保测试并执行自己的测量。

在不需要 Wi-Fi 的设计中,RF 前端组件可以从硬件设计中排除。 有关详细信息,请参阅 在 MT3620 上禁用 Wi-Fi RF 前端