bluetoothEnumerateInstalledServices 函数 (bluetoothapis.h)

项目
02/23/2024

BluetoothEnumerateInstalledServices 函数枚举在蓝牙设备上启用的服务 GUID (全局唯一标识符) 。

语法

DWORD BluetoothEnumerateInstalledServices(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  DWORD                       *pcServiceInout,
  GUID                        *pGuidServices
);

参数

hRadio

本地蓝牙无线电设备的句柄。如果 为 NULL，则搜索所有本地无线电，查找与 pbtdi 中的无线电地址匹配的已启用服务。

pbtdi

指向 BLUETOOTH_DEVICE_INFO 结构的指针。

pcServiceInout

输入时， pGuidServices 参数指向的记录数。输出时， pGuidServices 参数中返回的有效记录数。如果 pGuidServices 为 NULL，则输出 pcServices 包含已启用的服务数。

pGuidServices

指向内存中缓冲区的指针，用于接收已安装服务的 GUID。缓冲区必须至少为 *pcServices *大小， (GUID) 字节。

返回值

成功完成后返回ERROR_SUCCESS，pGuidServices 参数包含已启用的服务 GUID 的完整列表。

下表描述了一个常见错误：

返回代码	说明
ERROR_MORE_DATA	调用成功。 pGuidServices 参数包含已启用的服务 GUID 的不完整列表。

要求

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