BluetoothGetDeviceInfo 函数（bluetoothapis.h）

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

语法

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

hRadio

从对 BluetoothFindFirstRadio 或类似函数的调用或从对 SetupDiEnumDeviceInterfaces 函数的调用获取的本地无线电的句柄。

pbtdi

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

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

返回代码	描述
ERROR_REVISION_MISMATCH	BLUETOOTH_DEVICE_INFO的大小不兼容。检查 BLUETOOTH_DEVICE_INFO 结构的 dwSize 成员。
ERROR_NOT_FOUND	系统不知道无线电，或者 BLUETOOTH_DEVICE_INFO 结构的地址成员全部为零。
ERROR_INVALID_PARAMETER	pbtdi 参数 NULL。

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

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

要求	价值
最低支持的客户端	具有 SP2 的 Windows Vista、Windows XP [仅限桌面应用]
支持的最低服务器	不支持
目标平台	窗户
标头	bluetoothapis.h （包括 Bthsdpdef.h， BluetoothAPIs.h）
库	Bthprops.lib
DLL	bthprops.cpl