BluetoothGetDeviceInfo-Funktion (bluetoothapis.h)

Artikel
07/25/2024

Die BluetoothGetDeviceInfo Funktion ruft Informationen über ein Bluetooth-Remotegerät ab. Das Bluetooth-Gerät muss zuvor über einen erfolgreichen Geräteanfrage-Funktionsaufruf 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 an das BluetoothFindFirstRadio oder ähnliche Funktionen oder von einem Aufruf an die SetupDiEnumDeviceInterfaces-Funktion abgerufen wird.

pbtdi

Ein Zeiger auf eine BLUETOOTH_DEVICE_INFO Struktur, in die Daten zum ersten Bluetooth-Gerät platziert werden. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Gibt nach Erfolg ERROR_SUCCESS zurück, der angibt, dass Daten zum Remote-Bluetooth-Gerät abgerufen wurden. Gibt Fehlercodes bei Einem Fehler zurück. In der folgenden Tabelle sind allgemeine Fehlercodes aufgeführt, die der BluetoothGetDeviceInfo--Funktion zugeordnet sind.

Rückgabecode	Beschreibung
ERROR_REVISION_MISMATCH	Die Größe des BLUETOOTH_DEVICE_INFO ist nicht kompatibel. Überprüfen Sie das dwSize Member der BLUETOOTH_DEVICE_INFO Struktur.
ERROR_NOT_FOUND	Das Radio ist vom System nicht bekannt, oder das Address Member der BLUETOOTH_DEVICE_INFO Struktur ist alle Nullen.
ERROR_INVALID_PARAMETER	Der parameter pbtdi ist NULL.

Bemerkungen

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

In der BLUETOOTH_DEVICE_INFO Struktur, auf die durch pbtdiverwiesen wird, muss das dwSize Element der Größe in Byte der Struktur entsprechen. Das Address Member der BLUETOOTH_DEVICE_INFO-Struktur muss die Bluetooth-Adresse des Remotegeräts enthalten.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
mindestens unterstützte Server-	Keine unterstützt
Zielplattform-	Fenster
Header-	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
DLL-	bthprops.cpl