Función BluetoothEnableDiscovery (bluetoothapis.h)

Artículo
03/14/2023

La función BluetoothEnableDiscovery cambia el estado de detección de una radio o radio bluetooth local.

Sintaxis

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

Parámetros

hRadio

Identificador de radio local válido o NULL. Si es NULL, la detección se modifica en todas las radios locales; si la llamada modifica cualquier radio, la llamada a la función se realiza correctamente.

fEnabled

Marca que especifica si la detección se va a habilitar o deshabilitar. Establezca en TRUE para habilitar la detección, establezca en FALSE para deshabilitar la detección.

Valor devuelto

Devuelve TRUE si el estado de detección se cambió correctamente. Si hRadio es NULL, un valor devuelto de TRUE indica que al menos un estado de radio local se cambió correctamente. Devuelve FALSE si no se cambió el estado de detección; si hRadio era NULL, ningún radio aceptó el cambio de estado.

Comentarios

Usa la función BluetoothIsDiscoverable para determinar el estado actual de una radio Bluetooth. Windows garantiza que un sistema reconocible sea conectable y, como tal, la radio debe permitir las conexiones entrantes antes de que se pueda detectar una radio. Si no se permiten las conexiones entrantes, se produce un error en la llamada a la función BluetoothEnableDiscovery .

Cuando BluetoothEnableDiscovery cambia el estado de detección, el nuevo estado es válido durante la vigencia de la aplicación que realiza la llamada. Además, si una radio Bluetooth previamente ha sido reconocible con esta función está deshabilitada y se vuelve a habilitar a través de la aplicación, la detectabilidad no se conservará. Una vez finalizada la aplicación que llama, el estado de detección de la radio Bluetooth especificada revierte al estado en que estaba antes de llamar a BluetoothEnableDiscovery .

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 (incluye Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
Archivo DLL	bthprops.cpl