共用方式為


Networking_IpConfig_RenewIp函數

頁首: #include < applibs/networking。h>

續約裝置動態 IP 位址租賃。

注意

需要 Azure 球體 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 功能。

概念和範例