WifiConfig_ForgetNetwork函數

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

重要

此函數已過時。 請改用 WifiConfig_ForgetNetworkById 。

從裝置移除 Wi-Fi 網路。 如果裝置目前已連線，則中斷裝置與網路的連線。 此函數並不安全對話。

int WifiConfig_ForgetNetwork(const WifiConfig_StoredNetwork * storedNetwork);

參數

• storedNetwork 指向描述要移除 之儲存 Wi-Fi 網路的WifiConfig_StoredNetwork指示。

錯誤

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

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

• EFAULT：參數 ssid 為 Null。

• ENOENT：參數 storedNetwork 與任何儲存的網路不相符。

• EINVAL： storedNetwork 參數或其結構版本無效。

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

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

• ENOSPC：有太多 Wi-Fi 網路無法持續進行設定;移除其中一個，然後再試一次。

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

傳回值

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

應用程式資訊清單需求

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