Función BluetoothSetServiceState (bluetoothapis.h)

Artículo
08/22/2023

La función BluetoothSetServiceState habilita o deshabilita los servicios de un dispositivo Bluetooth.

Sintaxis

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

Parámetros

hRadio

Identificador de la radio Bluetooth local.

pbtdi

Puntero a una estructura BLUETOOTH_DEVICE_INFO . Debe ser una dirección de radio encontrada previamente.

pGuidService

Puntero al GUID del servicio en el dispositivo remoto.

dwServiceFlags

Marcas que ajustan el servicio. Para deshabilitar el servicio, establezca en BLUETOOTH_SERVICE_DISABLE; para habilitar el servicio, establezca en BLUETOOTH_SERVICE_ENABLE.

Valor devuelto

Devuelve ERROR_SUCCESS tras completarse correctamente. En la tabla siguiente se enumeran los errores comunes.

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	DwServiceFlags no son válidos.
ERROR_SERVICE_DOES_NOT_EXIST	No se admite el GUID especificado en pGuidService .
E_INVALIDARG	dwServiceFlags se establece en BLUETOOTH_SERVICE_DISABLE y el servicio ya está deshabilitado, o dwServiceFlags está establecido en BLUETOOTH_SERVICE_ENABLE y el servicio ya está habilitado.

Comentarios

Windows mantiene una asignación de identificadores únicos globales (GUID) de servicio a controladores compatibles con dispositivos habilitados para Bluetooth. Al habilitar un servicio, se instala el controlador de dispositivo correspondiente y la deshabilitación de un servicio se quita el controlador de dispositivo correspondiente. Si un servicio no compatible está habilitado, no se instala un controlador.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	bluetoothapis.h (incluya Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
Archivo DLL	bthprops.cpl