WifiConfig_SetTargetedScanEnabled函式
標頭: #include <applibs/wificonfig.h>
啟用或停用網路的目標掃描。 預設會停用目標掃描。
目標掃描可用來連線到未廣播其 SSID 的存取點,或位於嘈雜的環境中。
此設定會立即生效,但除非在此函式之後呼叫WifiConfig_PersistConfig函式,否則不會在裝置重新啟動之間保存。
重要
目標掃描會導致裝置將可能顯示網路 SSID 的探查要求傳送給其他裝置。 這應該只用於受控制的環境,或在此可接受風險的網路上使用。
static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);
參數
networkId
您要設定的網路識別碼。 使用 WifiConfig_AddNetwork 傳回新建立網路的網路標識碼。 網路標識碼會傳遞至 WifiConfig_Set* 函式以進行設定。 使用 WifiConfig_SetSSID 指定要針對掃描設定目標的 SSID。enabled
true
在網路上啟用目標掃描,否則為false
。
錯誤
如果遇到錯誤,並將 設定 errno
為錯誤值,則傳回 -1。
EACCES:應用程式指令清單不包含 WifiConfig 功能。
EAGAIN:Wi-Fi 裝置尚未就緒。
ENETDOWN:無法使用Wi-Fi網路介面。
EINVAL:
networkId
參數無效。ENODEV:
networkId
參數不符合任何預存網路。
您也可以指定任何其他 errno
錯誤;這類錯誤不具決定性,而且無法透過系統更新保留相同的行為。
傳回值
傳回 0 表示成功,或 -1 表示失敗,在此情況下 errno
會設定為錯誤值。
應用程式資訊清單需求
應用程式 指令清單 必須包含 WifiConfig 功能。