bluetoothFindFirstDevice 函数 (bluetoothapis.h)

项目
02/23/2024

BluetoothFindFirstDevice 函数开始枚举蓝牙设备。

语法

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_DEVICE_INFO 结构的指针，其中放置了有关找到的第一个蓝牙设备的信息。 pbtdi 指向的 BLUETOOTH_DEVICE_INFO 结构的 dwSize 成员必须与结构的大小匹配，否则对 BluetoothFindFirstDevice 函数的调用将失败。

返回值

成功完成后返回第一个蓝牙设备的有效句柄， pbtdi 参数指向有关设备的信息。当不再需要此句柄时，必须通过 BluetoothFindDeviceClose 将其关闭。

失败时返回 NULL 。有关错误的详细信息，请调用 GetLastError 函数。下表描述了常见错误：

返回代码	说明
ERROR_INVALID_PARAMETER	pbtsp 或 pbtdi 参数为 NULL。
ERROR_REVISION_MISMATCH	pbtsp 或 pbtdi 指向的结构大小不正确。

注解

BluetoothFindFirstDevice 函数找不到蓝牙低功耗 (LE) 设备。若要访问蓝牙 LE 设备，请使用Windows 运行时蓝牙低功耗 API。用于蓝牙的Windows 运行时 API 适用于 UWP 和经典桌面应用。

要求

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