BluetoothGetDeviceInfo-Funktion (bluetoothapis.h)

Artikel
02/23/2024

Die BluetoothGetDeviceInfo-Funktion ruft Informationen zu einem Bluetooth-Remotegerät ab. Das Bluetooth-Gerät muss zuvor durch einen erfolgreichen Geräteabfragefunktionsaufruf identifiziert worden sein.

Syntax

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Parameter

hRadio

Ein Handle für ein lokales Funkgerät, das von einem Aufruf von BluetoothFindFirstRadio oder ähnlichen Funktionen oder von einem Aufruf der SetupDiEnumerateDeviceInterfaces-Funktion abgerufen wird.

pbtdi

Ein Zeiger auf eine BLUETOOTH_DEVICE_INFO Struktur, in der Daten über das erste Bluetooth-Gerät platziert werden. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Gibt bei Erfolg ERROR_SUCCESS zurück, was angibt, dass Daten über das Bluetooth-Remotegerät abgerufen wurden. Gibt Fehlercodes bei Einem Fehler zurück. In der folgenden Tabelle sind häufige Fehlercodes aufgeführt, die der BluetoothGetDeviceInfo-Funktion zugeordnet sind.

Rückgabecode	Beschreibung
ERROR_REVISION_MISMATCH	Die Größe der BLUETOOTH_DEVICE_INFO ist nicht kompatibel. Überprüfen Sie den dwSize-Member der BLUETOOTH_DEVICE_INFO-Struktur .
ERROR_NOT_FOUND	Das Funkgerät ist dem System nicht bekannt, oder der Address-Member der BLUETOOTH_DEVICE_INFO-Struktur ist alle Nullen.
ERROR_INVALID_PARAMETER	Der pbtdi-Parameter ist NULL.

Hinweise

Das Bluetooth-Gerät, für das Daten abgerufen werden, muss zuvor durch einen erfolgreichen Geräteabfragefunktionsaufruf identifiziert worden sein.

In der BLUETOOTH_DEVICE_INFO Struktur, auf die pbtdi verweist, muss der dwSize-Member der Größe der Struktur in Bytes entsprechen. Der Address-Member der BLUETOOTH_DEVICE_INFO-Struktur muss die Bluetooth-Adresse des Remotegeräts enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Bibliothek	Bthprops.lib
DLL	bthprops.cpl