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 |
|---|---|
|
El usuario canceló la solicitud. |
|
El parámetro pbtsdp es NULL. |
|
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 |