Función BluetoothGetDeviceInfo (bluetoothapis.h)

Artículo
07/25/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 correcta a la función de consulta del dispositivo.

Sintaxis

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Parámetros

hRadio

Identificador de una radio local, obtenido de una llamada a la BluetoothFindFirstRadio o funciones similares, o desde una llamada a la función SetupDiEnumDeviceInterfaces.

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 Comentarios.

Valor devuelto

Devuelve ERROR_SUCCESS tras el éxito, lo que indica que se recuperaron 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.

Observaciones

El dispositivo Bluetooth para el que se obtienen los datos debe haberse identificado previamente a través de una llamada correcta a la función de consulta del dispositivo.

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	Valor
cliente mínimo admitido	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
servidor mínimo admitido	No se admite ninguna
de la plataforma de destino de	Windows
encabezado de	bluetoothapis.h (incluya Bthsdpdef.h, BluetoothAPIs.h)
biblioteca de	Bthprops.lib
DLL de	bthprops.cpl