Función BluetoothFindFirstDevice (bluetoothapis.h)

Artículo
02/23/2024

La función BluetoothFindFirstDevice inicia los dispositivos Bluetooth de enumeración.

Sintaxis

HBLUETOOTH_DEVICE_FIND BluetoothFindFirstDevice(
  const BLUETOOTH_DEVICE_SEARCH_PARAMS *pbtsp,
  BLUETOOTH_DEVICE_INFO                *pbtdi
);

Parámetros

pbtsp

Puntero a una estructura de BLUETOOTH_DEVICE_SEARCH_PARAMS . El miembro dwSize de la estructura BLUETOOTH_DEVICE_SEARCH_PARAMS a la que apunta pbtsp debe coincidir con el tamaño de la estructura.

pbtdi

Puntero a una estructura de BLUETOOTH_DEVICE_INFO en la que se coloca información sobre el primer dispositivo Bluetooth encontrado. El miembro dwSize de la estructura de BLUETOOTH_DEVICE_INFO a la que apunta pbtdi debe coincidir con el tamaño de la estructura o se produce un error en la llamada a la función BluetoothFindFirstDevice .

Valor devuelto

Devuelve un identificador válido al primer dispositivo Bluetooth tras completarse correctamente y el parámetro pbtdi apunta a información sobre el dispositivo. Cuando este controlador ya no es necesario, debe cerrarse a través de BluetoothFindDeviceClose.

Devuelve NULL tras un error. Llame a la función GetLastError para obtener más información sobre el error. En la tabla siguiente se describen los errores comunes:

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	El parámetro pbtsp o pbtdi es NULL.
ERROR_REVISION_MISMATCH	La estructura a la que apunta pbtsp o pbtdi no es el tamaño correcto.

Comentarios

La función BluetoothFindFirstDevice no encuentra dispositivos Bluetooth Low Energy (LE). Para acceder a los dispositivos Bluetooth LE, use las API de Windows Runtime Bluetooth Low Energy. Las API de Windows Runtime para Bluetooth funcionan tanto en aplicaciones de escritorio para UWP como en aplicaciones de escritorio clásicas.

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