Función BluetoothGetDeviceInfo (bluetoothapis.h)

Artículo
02/26/2024

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
ERROR_REVISION_MISMATCH	El tamaño del BLUETOOTH_DEVICE_INFO no es compatible. Compruebe el miembro dwSize de la estructura BLUETOOTH_DEVICE_INFO .
ERROR_NOT_FOUND	El sistema no conoce la radio o el miembro Address de la estructura BLUETOOTH_DEVICE_INFO es ceros.
ERROR_INVALID_PARAMETER	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