WifiConfig_ForgetNetworkById函數

頁首： #include < applibs/wificonfig.h>

從裝置移除 Wi-Fi 網路。 如果裝置目前已連線，則中斷裝置與網路的連線。

此設定會立即生效，但不會在裝置重新開機時持續執行，除非在此函數之後撥打 WifiConfig_PersistConfig 函數。

int WifiConfig_ForgetNetworkById(int networkId);

參數

• networkId 要移除的網路識別碼。

錯誤

如果發生錯誤並設定為 errno 錯誤值，則傳回 -1。

• EACCES：應用程式資訊清單不包含 WifiConfig 功能。

• EINVAL：參數 networkId 無效。

• ENOENT：參數 networkId 與 儲存網路的任何識別碼不相符。

• EAGAIN：Wi-Fi 裝置尚未準備就緒。

• ENETDOWN：無法使用 Wi-Fi 網路介面。

您也可以指定任何其他 errno 錯誤;這類錯誤不是不確定的，同樣的行為可能無法透過系統更新來保留。

傳回值

會傳回 0 表示成功，而失敗則傳回 -1，在這種情況下 errno 會設定為錯誤值。

應用程式資訊清單需求

應用程式 資訊清單 必須包含 WifiConfig 功能。