WifiConfig_SetTargetedScanEnabled関数
ヘッダー: applibs </wificonfig.h #include>
ネットワークの対象スキャンを有効または無効にします。 ターゲット スキャンは既定で無効になっています。
ターゲット スキャンは、SSID をブロードキャストしていない、またはノイズの多い環境にあるアクセス ポイントに接続するために使用されます。
この設定はすぐに有効ですが、この関数の後に WifiConfig_PersistConfig 関数が呼び出されない限り、デバイスの再起動後も保持されません。
大事な
ターゲット スキャンにより、デバイスは、ネットワークの SSID を明らかにする可能性があるプローブ要求を他のデバイスに送信します。 これは、制御された環境、または許容されるリスクがあるネットワークでのみ使用する必要があります。
static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);
パラメーター
networkId
構成するネットワークの ID。 WifiConfig_AddNetworkを使用して、新しく作成されたネットワークのネットワーク ID を返します。 ネットワーク ID は、構成のために WifiConfig_Set* 関数に渡されます。 WifiConfig_SetSSIDを使用して、スキャンのターゲットとなる SSID を指定します。enabled
true
ネットワークでターゲット スキャンを有効にする場合。それ以外の場合は 。false
エラー
エラーが発生した場合は -1 を返し、エラー値に設定します errno
。
EACCES: アプリケーション マニフェストに WifiConfig 機能が含まれていません。
EAGAIN: Wi-Fi デバイスの準備ができていない。
ENETDOWN: Wi-Fi ネットワーク インターフェイスは使用できません。
EINVAL:
networkId
パラメーターが無効です。ENODEV: パラメーターが
networkId
格納されているネットワークのいずれにも一致しません。
その他 errno
のエラーも指定できます。このようなエラーは決定的ではなく、同じ動作はシステム更新によって保持されない可能性があります。
戻り値
成功の場合は 0、失敗の場合は -1 を返します。この場合 errno
はエラー値に設定されます。
アプリケーション マニフェストの要件
アプリケーション マニフェストには、WifiConfig 機能が含まれている必要があります。