Funzione BluetoothFindNextDevice (bluetoothapis.h)

Articolo
02/23/2024

La funzione BluetoothFindNextDevice trova il dispositivo Bluetooth successivo.

Sintassi

BOOL BluetoothFindNextDevice(
  HBLUETOOTH_DEVICE_FIND hFind,
  BLUETOOTH_DEVICE_INFO  *pbtdi
);

Parametri

hFind

Handle per la query ottenuta in una chiamata precedente alla funzione BluetoothFindFirstDevice .

pbtdi

Puntatore a una struttura di BLUETOOTH_DEVICE_INFO in cui vengono posizionate le informazioni sul dispositivo Bluetooth successivo trovato. Il membro dwSize della struttura BLUETOOTH_DEVICE_INFO a cui punta pbtdi deve corrispondere alla dimensione della struttura oppure la chiamata a BluetoothFindNextDevice ha esito negativo.

Valore restituito

Restituisce TRUE quando il dispositivo successivo viene trovato correttamente e il parametro pbtdi punta a informazioni sul dispositivo. Restituisce FALSE in caso di errore. Chiamare la funzione GetLastError per altre informazioni sull'errore. La tabella seguente descrive gli errori comuni:

Codice restituito	Descrizione
ERROR_INVALID_HANDLE	L'handle è NULL.
ERROR_NO_MORE_ITEMS	Non sono stati trovati altri dispositivi.
ERROR_OUTOFMEMORY	Memoria insufficiente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Libreria	Bthprops.lib
DLL	bthprops.cpl