BluetoothEnableDiscovery 関数 (bluetoothapis.h)

[アーティクル]
02/26/2024

BluetoothEnableDiscovery 関数は、ローカルの Bluetooth 無線または無線の検出状態を変更します。

構文

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

パラメーター

hRadio

有効なローカル無線ハンドル、または NULL。 NULL の場合、検出はすべてのローカル無線で変更されます。呼び出しによって無線が変更された場合、関数呼び出しは成功します。

fEnabled

検出を有効にするか無効にするかを指定するフラグ。検出を有効にするには TRUE に設定し、検出を無効にするには FALSE に設定します。

戻り値

検出状態が正常に変更された場合は TRUE を 返します。 hRadio が NULL の場合、TRUE の戻り値は、少なくとも 1 つのローカル無線状態が正常に変更されたことを示します。検出状態が変更されなかった場合は FALSE を 返します。 hRadio が NULL の場合、状態の変更を受け入れた無線はありません。

注釈

BluetoothIsDiscoverable 関数を使用して、Bluetooth 無線の現在の状態を確認します。 Windows では、検出可能なシステムが接続可能であることが保証されるため、無線を検出可能にする前に、無線で受信接続を許可する必要があります。着信接続を許可しないと、 BluetoothEnableDiscovery 関数呼び出しが失敗します。

BluetoothEnableDiscovery によって検出状態が変更されると、呼び出し元アプリケーションの有効期間中、新しい状態が有効になります。さらに、以前にこの機能を使用して検出可能にした Bluetooth 無線が無効にされ、アプリケーションを介して再度有効になっている場合、検出可能性は維持されません。呼び出し元のアプリケーションが終了すると、指定された Bluetooth 無線の検出状態は、 BluetoothEnableDiscovery が呼び出される前の状態に戻ります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む)
Library	Bthprops.lib
[DLL]	bthprops.cpl