Función BluetoothSelectDevices (bluetoothapis.h)

La función BluetoothSelectDevices habilita la selección de dispositivos Bluetooth.

Sintaxis

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

Parámetros

pbtsdp

Puntero a una estructura de BLUETOOTH_SELECT_DEVICE_PARAMS que identifica los dispositivos Bluetooth.

Valor devuelto

Devuelve TRUE si un usuario seleccionó un dispositivo.

Devuelve FALSE si no se devolvieron datos válidos. Llame a la función GetLastError para recuperar información de error. Las condiciones siguientes se aplican a la información de error devuelta.

Código devuelto Descripción
ERROR_CANCELLED
El usuario canceló la solicitud.
ERROR_INVALID_PARAMETER
El parámetro pbtsdp es NULL.
ERROR_REVISION_MISMATCH
La estructura pasada en pbtsdp es de tamaño desconocido.

Comentarios

La función BluetoothSelectDevices abre un cuadro de diálogo común para seleccionar dispositivos Bluetooth. La lista de dispositivos que se muestran al usuario viene determinada por las marcas y la configuración que especifica el autor de la llamada en el parámetro pbtsdp .

Si BluetoothSelectDevices devuelve TRUE, el miembro pDevices de la estructura BLUETOOTH_SELECT_DEVICE_PARAMS apunta a datos válidos. El autor de la llamada debe comprobar que las marcas fAuthenticated y fRemembered de la estructura BLUETOOTH_SELECT_DEVICE_PARAMS para determinar qué dispositivos se autenticaron correctamente y qué dispositivos son selecciones válidas para el usuario. Llame a la función BluetoothSelectDevicesFree para liberar recursos solo si la función BluetoothSelectDevices devuelve TRUE.

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

Consulte también

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK