BluetoothFindFirstDevice 関数 (bluetoothapis.h)

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

BluetoothFindFirstDevice 関数は、列挙 Bluetooth デバイスを開始します。

構文

HBLUETOOTH_DEVICE_FIND BluetoothFindFirstDevice(
  const BLUETOOTH_DEVICE_SEARCH_PARAMS *pbtsp,
  BLUETOOTH_DEVICE_INFO                *pbtdi
);

パラメーター

pbtsp

BLUETOOTH_DEVICE_SEARCH_PARAMS構造体へのポインター。 pbtsp が指すBLUETOOTH_DEVICE_SEARCH_PARAMS構造体の dwSize メンバーは、構造体のサイズと一致する必要があります。

pbtdi

最初に検出された Bluetooth デバイスに関する情報が配置されるBLUETOOTH_DEVICE_INFO構造体へのポインター。 pbtdi が指すBLUETOOTH_DEVICE_INFO構造体の dwSize メンバーは、構造体のサイズと一致する必要があります。または、BluetoothFindFirstDevice 関数の呼び出しが失敗します。

戻り値

正常に完了すると、最初の Bluetooth デバイスへの有効なハンドルを返し、 pbtdi パラメーターは デバイスに関する情報を指します。このハンドルが不要になった場合は、 BluetoothFindDeviceClose を使用して閉じる必要があります。

失敗した場合は NULL を 返します。エラーの詳細については、 GetLastError 関数を呼び出します。次の表では、一般的なエラーについて説明します。

リターンコード	説明
ERROR_INVALID_PARAMETER	pbtsp または pbtdi パラメーターは NULL です。
ERROR_REVISION_MISMATCH	pbtsp または pbtdi が指す構造体が正しいサイズではありません。

注釈

BluetoothFindFirstDevice 関数では、Bluetooth Low Energy (LE) デバイスが見つかりません。 Bluetooth LE デバイスにアクセスするには、Windows ランタイム Bluetooth Low Energy API を使用します。 Bluetooth 用Windows ランタイム API は、UWP とクラシックデスクトップアプリの両方で機能します。

要件

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