Funzione BluetoothFindFirstDevice (bluetoothapis.h)

Articolo
02/23/2024

La funzione BluetoothFindFirstDevice inizia l'enumerazione Dei dispositivi Bluetooth.

Sintassi

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

Parametri

pbtsp

Puntatore a una struttura BLUETOOTH_DEVICE_SEARCH_PARAMS . Il membro dwSize della struttura BLUETOOTH_DEVICE_SEARCH_PARAMS puntato da pbtsp deve corrispondere alle dimensioni della struttura.

pbtdi

Puntatore a una struttura BLUETOOTH_DEVICE_INFO in cui vengono inserite le informazioni sul primo dispositivo Bluetooth trovato. Il membro dwSize della struttura BLUETOOTH_DEVICE_INFO puntato da pbtdi deve corrispondere alla dimensione della struttura oppure la chiamata alla funzione BluetoothFindFirstDevice ha esito negativo.

Valore restituito

Restituisce un handle valido al primo dispositivo Bluetooth al termine del completamento e il parametro pbtdi punta a informazioni sul dispositivo. Quando questo handle non è più necessario, deve essere chiuso tramite BluetoothFindDeviceClose.

Restituisce NULL 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_PARAMETER	Il parametro pbtsp o pbtdi è NULL.
ERROR_REVISION_MISMATCH	La struttura puntata da pbtsp o pbtdi non è la dimensione corretta.

Commenti

La funzione BluetoothFindFirstDevice non trova dispositivi Bluetooth Low Energy (LE). Per accedere ai dispositivi Bluetooth LE, usare le API Bluetooth Low Energy Windows Runtime. Le API Windows Runtime per il funzionamento Bluetooth in app desktop UWP e classiche.

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 (includere Bthsdpdef.h, BluetoothAPIs.h)
Libreria	Bthprops.lib
DLL	bthprops.cpl