Функция BluetoothSetServiceState (bluetoothapis.h)

Статья
08/22/2023

Функция BluetoothSetServiceState включает или отключает службы для устройства Bluetooth.

Синтаксис

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

Параметры

hRadio

Дескриптор локального радиомодуля Bluetooth.

pbtdi

Указатель на структуру BLUETOOTH_DEVICE_INFO . Должен быть ранее найденным радиоадресом.

pGuidService

Указатель на GUID службы на удаленном устройстве.

dwServiceFlags

Флаги, которые настраивают службу. Чтобы отключить службу, задайте для параметра значение BLUETOOTH_SERVICE_DISABLE; Чтобы включить службу, задайте для значение BLUETOOTH_SERVICE_ENABLE.

Возвращаемое значение

Возвращает ERROR_SUCCESS после успешного завершения. В следующей таблице перечислены распространенные ошибки.

Код возврата	Описание
ERROR_INVALID_PARAMETER	Недопустимые dwServiceFlags.
ERROR_SERVICE_DOES_NOT_EXIST	Идентификатор GUID, указанный в pGuidService , не поддерживается.
E_INVALIDARG	Параметру dwServiceFlags присвоено значение BLUETOOTH_SERVICE_DISABLE и служба уже отключена, или параметру dwServiceFlags присвоено значение BLUETOOTH_SERVICE_ENABLE и служба уже включена.

Windows поддерживает сопоставление глобальных уникальных идентификаторов (GUID) службы с поддерживаемыми драйверами для устройств с поддержкой Bluetooth. При включении службы устанавливается соответствующий драйвер устройства, а при отключении службы удаляется соответствующий драйвер устройства. Если включена не поддерживаемая служба, драйвер не устанавливается.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	bluetoothapis.h (включая Bthsdpdef.h, BluetoothAPIs.h)
Библиотека	Bthprops.lib
DLL	bthprops.cpl