Networking_IpConfig_ReleaseIp 函数
标头: #include <applibs/networking.h>
释放设备动态 IP 地址。
注意
需要 Azure Sphere OS 版本 22.02 或更高版本。
int Networking_IpConfig_ReleaseIp(const char *networkInterfaceName);
参数
-
networkInterfaceName
指向要更新的网络接口名称的指针。
错误
如果遇到错误并设置为 errno
错误值,则返回 -1。
EACCES:调用应用程序没有 NetworkConfig 功能。
EFAULT:
networkInterfaceName
参数为 NULL。ENOENT:网络接口不存在。
EPERM:无法释放 IP 地址,例如在静态 IP 配置中。
还可以指定任何其他 errno
错误;此类错误不是确定性的,并且可能不会通过系统更新保留相同的行为。
返回值
成功返回 0,失败返回 -1,在这种情况下 errno
,设置为错误值。
言论
如果 IP 是通过 DHCP 获取的,则此 API 会同步发送 DHCP 发布消息,但不能保证收到该消息。 此 API 阻止 DHCP 协议尝试获取 IP 地址,直到调用 Networking_IpConfig_RenewIp 。
应用程序清单必须包含 NetworkConfig 功能。