次の方法で共有


BluetoothGetDeviceInfo 関数 (bluetoothapis.h)

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

構文

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

パラメーター

hRadio

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

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 メンバーがすべて 0 です。
ERROR_INVALID_PARAMETER
pbtdi パラメーターは NULLです。

備考

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

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista、WINDOWS XP SP2 [デスクトップ アプリのみ]
サポートされる最小サーバー サポートされていません
ターゲット プラットフォーム の ウィンドウズ
ヘッダー bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む)
ライブラリ Bthprops.lib
DLL bthprops.cpl

関連項目

BLUETOOTH_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothRemoveDevice