Funzione BluetoothGetDeviceInfo (bluetoothapis.h)

Articolo
07/25/2024

La funzione BluetoothGetDeviceInfo recupera informazioni su un dispositivo Bluetooth remoto. Il dispositivo Bluetooth deve essere stato identificato in precedenza tramite una chiamata di funzione di richiesta del dispositivo riuscita.

Sintassi

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Parametri

hRadio

Handle per una radio locale, ottenuto da una chiamata al BluetoothFindFirstRadio o da una chiamata alla funzione SetupDiEnumDeviceInterfaces.

pbtdi

Puntatore a una struttura BLUETOOTH_DEVICE_INFO in cui verranno posizionati i dati relativi al primo dispositivo Bluetooth. Per altre informazioni, vedere Osservazioni.

Valore restituito

Restituisce ERROR_SUCCESS in caso di esito positivo, a indicare che i dati sul dispositivo Bluetooth remoto sono stati recuperati. Restituisce i codici di errore in caso di errore. Nella tabella seguente sono elencati i codici di errore comuni associati alla funzione BluetoothGetDeviceInfo.

Codice restituito	Descrizione
ERROR_REVISION_MISMATCH	Le dimensioni del BLUETOOTH_DEVICE_INFO non sono compatibili. Controllare il membro dwSize della struttura BLUETOOTH_DEVICE_INFO.
ERROR_NOT_FOUND	La radio non è nota dal sistema o dal membro address della struttura BLUETOOTH_DEVICE_INFO è tutti zeri.
ERROR_INVALID_PARAMETER	Il parametro pbtdi è NULL.

Osservazioni

Il dispositivo Bluetooth per cui si ottengono i dati deve essere stato identificato in precedenza tramite una chiamata di funzione di richiesta del dispositivo riuscita.

Nella struttura BLUETOOTH_DEVICE_INFO a cui punta pbtdi, il membro dwSize deve essere equivalente alla dimensione, espressa in byte, della struttura. Il membro Address della struttura BLUETOOTH_DEVICE_INFO deve contenere l'indirizzo Bluetooth del dispositivo remoto.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
server minimo supportato	Nessuna supportata
piattaforma di destinazione	Finestre
intestazione	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
libreria	Bthprops.lib
dll	bthprops.cpl