Networking_IpConfig_RenewIp 函数

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

续订设备动态 IP 地址租约。

注意

需要 Azure Sphere OS 版本 22.02 或更高版本。

int Networking_IpConfig_RenewIp(const char *networkInterfaceName);

参数

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

错误

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

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

  • EFAULT: networkInterfaceName 参数为 NULL。

  • ENOENT:网络接口不存在。

  • EPERM:无法续订 IP 地址,例如在静态 IP 配置中。

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

返回值

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

言论

如果 IP 地址是通过 DHCP 获取的,则此函数会异步续订当前 IP 地址租约。 如果 DHCP 仍在努力获取 IP 地址,则此函数不执行任何操作。 如果 DHCP 协议已使用 Networking_IpConfig_ReleaseIp 停止,则 DHCP 事务将重新启动。 使用 Networking_IsNetworkingReady 确定是否获取了新 IP。

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

概念和示例