Função BluetoothSetServiceState (bluetoothapis.h)

Artigo
03/14/2023

A função BluetoothSetServiceState habilita ou desabilita serviços para um dispositivo Bluetooth.

Sintaxe

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

Parâmetros

hRadio

Um identificador do rádio Bluetooth local.

pbtdi

Um ponteiro para uma estrutura BLUETOOTH_DEVICE_INFO . Deve ser um endereço de rádio encontrado anteriormente.

pGuidService

Um ponteiro para o GUID do serviço no dispositivo remoto.

dwServiceFlags

Os sinalizadores que ajustam o serviço. Para desabilitar o serviço, defina como BLUETOOTH_SERVICE_DISABLE; para habilitar o serviço, defina como BLUETOOTH_SERVICE_ENABLE.

Retornar valor

Retorna ERROR_SUCCESS após a conclusão bem-sucedida. A tabela a seguir lista erros comuns.

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	Os dwServiceFlags não são válidos .
ERROR_SERVICE_DOES_NOT_EXIST	Não há suporte para o GUID especificado em pGuidService .
E_INVALIDARG	dwServiceFlags está definido como BLUETOOTH_SERVICE_DISABLE e o serviço já está desabilitado ou dwServiceFlags está definido como BLUETOOTH_SERVICE_ENABLE e o serviço já está habilitado.

Comentários

O Windows mantém um mapeamento de GUIDs (Identificadores Globalmente Exclusivos) de serviço para drivers com suporte para dispositivos habilitados para Bluetooth. Habilitar um serviço instala o driver de dispositivo correspondente e desabilitar um serviço remove o driver de dispositivo correspondente. Se um serviço sem suporte estiver habilitado, um driver não será instalado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	bluetoothapis.h (inclua Bthsdpdef.h, BluetoothAPIs.h)
Biblioteca	Bthprops.lib
DLL	bthprops.cpl