BluetoothGetDeviceInfo 函数 (bluetoothapis.h)

BluetoothGetDeviceInfo 函数检索有关远程蓝牙设备的信息。蓝牙设备必须事先通过成功的设备查询函数调用进行标识。

语法

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

hRadio

本地无线电的句柄，通过对 BluetoothFindFirstRadio 或类似函数的调用或对 SetupDiEnumerateDeviceInterfaces 函数的调用获取。

pbtdi

指向 BLUETOOTH_DEVICE_INFO 结构的指针，其中放置有关第一个蓝牙设备的数据。有关详细信息，请参阅“备注”。

成功时返回 ERROR_SUCCESS ，指示已检索到有关远程蓝牙设备的数据。失败时返回错误代码。下表列出了与 BluetoothGetDeviceInfo 函数关联的常见错误代码。

返回代码	说明
ERROR_REVISION_MISMATCH	BLUETOOTH_DEVICE_INFO的大小不兼容。检查BLUETOOTH_DEVICE_INFO结构的 dwSize 成员。
ERROR_NOT_FOUND	系统不知道无线电，或者BLUETOOTH_DEVICE_INFO结构的 Address 成员都是零。
ERROR_INVALID_PARAMETER	pbtdi 参数为 NULL。

获取数据的蓝牙设备必须事先通过成功的设备查询函数调用进行标识。

在 pbtdi 指向的BLUETOOTH_DEVICE_INFO结构中，dwSize 成员必须与结构的大小（以字节为单位）等效。 BLUETOOTH_DEVICE_INFO结构的地址成员必须包含远程设备的蓝牙地址。

要求	值
最低受支持的客户端	Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
Library	Bthprops.lib
DLL	bthprops.cpl