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。

• enabledtrue在網路上啟用目標掃描，否則為 false。

錯誤

如果遇到錯誤，並將 設定 errno 為錯誤值，則傳回 -1。

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

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

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

• EINVAL： networkId 參數無效。

• ENODEV： networkId 參數不符合任何預存網路。

您也可以指定任何其他 errno 錯誤;這類錯誤不具決定性，而且無法透過系統更新保留相同的行為。

傳回值

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

應用程式資訊清單需求

應用程式 指令清單 必須包含 WifiConfig 功能。