WifiConfig_AddNetwork函數

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

將 Wi-Fi 網路新增至裝置，並傳回網路識別碼。

int WifiConfig_AddNetwork(void);

錯誤

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

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

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

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

• ENOMEM：沒有足夠的記憶體可以新增網路。

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

傳回值

傳回新網路的識別碼，或是 -1 表示失敗，在這種情況下 errno 會設定為錯誤值。 網路識別碼為零或正數值。

言論

網路識別碼會傳遞給 WifiConfig_Set* 函數，例如 WifiConfig_SetSSID。

新網路未設定，且可以使用 WifiConfig_Set* 函數來設定。 網路設定的變更會立即生效，但會在裝置重新開機時遺失 ，除非WifiConfig_PersistConfig 函數被叫來將設定儲存至非行動儲存空間。

您可儲存在裝置上的網路數目並未修正，但需視可用資源及每個網路設定所需的儲存量而定。

應用程式資訊清單需求

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