Funzione BluetoothGetDeviceInfo (bluetoothapis.h)

Articolo
02/26/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 a una radio locale, ottenuto da una chiamata alle funzioni BluetoothFindFirstRadio o simili oppure da una chiamata alla funzione SetupDiEnumerateDeviceInterfaces .

pbtdi

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

Valore restituito

Restituisce ERROR_SUCCESS in caso di esito positivo, a indicare che i dati relativi al 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 il membro Address della struttura BLUETOOTH_DEVICE_INFO è tutti zeri.
ERROR_INVALID_PARAMETER	Il parametro pbtdi è NULL.

Commenti

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, in byte, della struttura. Il membro Address della struttura BLUETOOTH_DEVICE_INFO deve contenere l'indirizzo Bluetooth del dispositivo remoto.

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