共用方式為


WifiConfig_AddDuplicateNetwork函數

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

新增具有指定識別碼之指定網路複本的新網路。 新網路會指派指定的名稱,並預設為停用。

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

參數

  • networkId 複製的網路識別碼。 WifiConfig_AddNetwork 傳回網路識別碼。

  • configName 指向包含組態名稱之位元組陣列的指標。 陣列必須是 Null 終止,且最多必須WIFICONFIG_CONFIG_NAME_MAX_LENGTH位元組,但不會包含終止字元。

錯誤

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

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

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

  • EEXIST:這 configName 並非唯一。

  • EFAULT:IS configName Null。

  • EINVAL:無效 networkId

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

  • ENODEV:與 networkId 任何儲存的網路不相符。

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

  • ERANGE:其 configName 字元少於一個或超過WIFICONFIG_CONFIG_NAME_MAX_LENGTH個字元。

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

傳回值

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

言論

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

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

應用程式資訊清單需求

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