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:或
networkInterfaceName
ipConfig
參數為 Null。EAGAIN:網路堆疊尚未準備就緒。
您也可以指定任何其他 errno
錯誤;這類錯誤不是不確定的,同樣的行為可能無法透過系統更新來保留。
傳回值
傳回 0 表示成功,傳回 -1 表示失敗,在這種情況下 errno
會設定為錯誤值。
言論
此函數不會確認靜態 IP 位址是否與使用 DHCP 用戶端介面透過介面接收到的動態 IP 位址相容。
此函數不會確認網路上是否提供 DHCP 伺服器,以及是否已設定動態 IP 位址。
如果裝置上出現重迭的 IP 位址設定,則此函數的行為未定義。
應用程式資訊清單需求
應用程式 資訊清單 必須包含 NetworkConfig 功能。