BluetoothGetDeviceInfo 関数 (bluetoothapis.h)

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

BluetoothGetDeviceInfo 関数は、リモート Bluetooth デバイスに関する情報を取得します。 Bluetooth デバイスは、デバイスの照会関数呼び出しに成功して以前に識別されている必要があります。

構文

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

パラメーター

hRadio

BluetoothFindFirstRadio または同様の関数の呼び出し、または SetupDiEnumerateDeviceInterfaces 関数の呼び出しから取得されたローカル無線へのハンドル。

pbtdi

最初の Bluetooth デバイスに関するデータが配置される BLUETOOTH_DEVICE_INFO 構造体へのポインター。詳細については、「解説」を参照してください。

戻り値

成功 ERROR_SUCCESS 返します。リモート Bluetooth デバイスに関するデータが取得されたことを示します。エラー発生時にエラーコードを返します。次の表に、 BluetoothGetDeviceInfo 関数に関連付けられている一般的なエラーコードを示します。

リターンコード	説明
ERROR_REVISION_MISMATCH	BLUETOOTH_DEVICE_INFOのサイズに互換性がありません。 BLUETOOTH_DEVICE_INFO構造体の dwSize メンバーを確認します。
ERROR_NOT_FOUND	無線がシステムによって認識されていないか、BLUETOOTH_DEVICE_INFO構造体の Address メンバーがすべてゼロです。
ERROR_INVALID_PARAMETER	pbtdi パラメーターは NULL です。

注釈

データが取得される Bluetooth デバイスは、デバイスの照会関数呼び出しが成功したことを通じて、以前に識別されている必要があります。

pbtdi が指すBLUETOOTH_DEVICE_INFO構造体では、dwSize メンバーは構造体のサイズ (バイト単位) に相当する必要があります。 BLUETOOTH_DEVICE_INFO構造体の Address メンバーには、リモートデバイスの Bluetooth アドレスが含まれている必要があります。

要件

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