Networking_IpConfig_Apply 函数

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

将 IP 配置应用于网络接口。

int Networking_IpConfig_Apply(const char *networkInterfaceName, const Networking_IpConfig *ipConfig);

参数

  • networkInterfaceName 要配置的网络接口的名称。

  • ipConfig 指向包含要应用的 IP 配置的 Networking_IpConfig 结构的指针。

错误

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

  • EACCES:调用应用程序没有 NetworkConfig 功能。

  • ENOENT: networkInterfaceName 参数引用不存在的接口。

  • EPERM:网络接口上不允许此操作。

  • EFAULT: networkInterfaceNameipConfig 参数为 NULL。

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

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

返回值

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

言论

此函数不会验证静态 IP 地址是否与使用 DHCP 客户端通过接口接收的动态 IP 地址兼容。

此函数不会验证 DHCP 服务器在网络上是否可用以及是否配置了动态 IP 地址。

如果设备上存在重叠的 IP 地址配置,则此函数的行为是未定义的。

应用程序清单要求

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

概念和示例