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