Función BluetoothEnableDiscovery (bluetoothapis.h)
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 |
Consulte también
BluetoothAuthenticateMultipleDevices
BluetoothEnableIncomingConnections
BluetoothRegisterForAuthentication