Función BluetoothGetDeviceInfo (bluetoothapis.h)
La función BluetoothGetDeviceInfo recupera información sobre un dispositivo Bluetooth remoto. El dispositivo Bluetooth debe haberse identificado previamente a través de una llamada de función de consulta de dispositivo correcta.
Sintaxis
DWORD BluetoothGetDeviceInfo(
HANDLE hRadio,
BLUETOOTH_DEVICE_INFO *pbtdi
);
Parámetros
hRadio
Identificador de una radio local, obtenido de una llamada a bluetoothFindFirstRadio o funciones similares, o desde una llamada a la función SetupDiEnumerateDeviceInterfaces .
pbtdi
Puntero a una estructura BLUETOOTH_DEVICE_INFO en la que se colocarán los datos sobre el primer dispositivo Bluetooth. Para obtener más información, vea la sección Comentarios.
Valor devuelto
Devuelve ERROR_SUCCESS si se realiza correctamente, lo que indica que se recuperaron los datos sobre el dispositivo Bluetooth remoto. Devuelve códigos de error tras un error. En la tabla siguiente se enumeran los códigos de error comunes asociados a la función BluetoothGetDeviceInfo .
Código devuelto | Descripción |
---|---|
|
El tamaño del BLUETOOTH_DEVICE_INFO no es compatible. Compruebe el miembro dwSize de la estructura BLUETOOTH_DEVICE_INFO . |
|
El sistema no conoce la radio o el miembro Address de la estructura BLUETOOTH_DEVICE_INFO es ceros. |
|
El parámetro pbtdi es NULL. |
Comentarios
El dispositivo Bluetooth para el que se obtienen los datos debe haberse identificado previamente a través de una llamada de función de consulta de dispositivo correcta.
En la estructura de BLUETOOTH_DEVICE_INFO a la que apunta pbtdi, el miembro dwSize debe ser equivalente al tamaño, en bytes, de la estructura. El miembro Address de la estructura BLUETOOTH_DEVICE_INFO debe contener la dirección Bluetooth del dispositivo remoto.
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
BLUETOOTH_DEVICE_SEARCH_PARAMS
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de