次の方法で共有


WifiConfig_SetTargetedScanEnabled 関数

Header: #include <applibs/wificonfig.h>

ネットワークに対する特定対象のスキャンを有効または無効にします。 特定対象のスキャンは既定では無効です。

特定対象のスキャンは、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 機能が含まれている必要があります。