bluetoothSetServiceState 函数 (bluetoothapis.h)

项目
02/26/2024

BluetoothSetServiceState 函数启用或禁用蓝牙设备的服务。

语法

DWORD BluetoothSetServiceState(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  const GUID                  *pGuidService,
  DWORD                       dwServiceFlags
);

参数

hRadio

本地蓝牙无线电的句柄。

pbtdi

指向 BLUETOOTH_DEVICE_INFO 结构的指针。必须是以前找到的单选地址。

pGuidService

指向远程设备上的服务 GUID 的指针。

dwServiceFlags

调整服务的标志。若要禁用该服务，请将设置为 BLUETOOTH_SERVICE_DISABLE;若要启用该服务，请将设置为 BLUETOOTH_SERVICE_ENABLE。

返回值

成功完成后返回 ERROR_SUCCESS 。下表列出了常见错误。

返回代码	说明
ERROR_INVALID_PARAMETER	dwServiceFlags 无效。
ERROR_SERVICE_DOES_NOT_EXIST	不支持 pGuidService 中指定的 GUID 。
E_INVALIDARG	dwServiceFlags 设置为 BLUETOOTH_SERVICE_DISABLE 且服务已禁用，或 dwServiceFlags 设置为 BLUETOOTH_SERVICE_ENABLE 且服务已启用。

注解

Windows 维护服务全局唯一标识符 (GUID 的映射，) 支持蓝牙的设备驱动程序。启用服务会安装相应的设备驱动程序，禁用服务会删除相应的设备驱动程序。如果启用了不支持的服务，则不会安装驱动程序。

要求

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