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 功能。