Función BluetoothFindNextDevice (bluetoothapis.h)

Artículo
03/14/2023

La función BluetoothFindNextDevice encuentra el siguiente dispositivo Bluetooth.

Sintaxis

BOOL BluetoothFindNextDevice(
  HBLUETOOTH_DEVICE_FIND hFind,
  BLUETOOTH_DEVICE_INFO  *pbtdi
);

Parámetros

hFind

Identificador de la consulta obtenida en una llamada anterior a la función BluetoothFindFirstDevice .

pbtdi

Puntero a una estructura de BLUETOOTH_DEVICE_INFO en la que se coloca información sobre el siguiente 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 BluetoothFindNextDevice .

Valor devuelto

Devuelve TRUE cuando se encuentra correctamente el siguiente dispositivo y el parámetro pbtdi apunta a información sobre el dispositivo. Devuelve FALSE tras el 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_HANDLE	El identificador es NULL.
ERROR_NO_MORE_ITEMS	No se encontraron más dispositivos.
ERROR_OUTOFMEMORY	Memoria insuficiente

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