BluetoothFindFirstDevice-Funktion (bluetoothapis.h)

Artikel
02/23/2024

Die BluetoothFindFirstDevice-Funktion beginnt die Enumeration Bluetooth-Geräte.

Syntax

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

Parameter

pbtsp

Zeiger auf eine BLUETOOTH_DEVICE_SEARCH_PARAMS-Struktur . Das dwSize-Element der BLUETOOTH_DEVICE_SEARCH_PARAMS Struktur, auf die pbtsp verweist, muss der Größe der Struktur entsprechen.

pbtdi

Zeiger auf eine BLUETOOTH_DEVICE_INFO Struktur, in der Informationen über das erste gefundene Bluetooth-Gerät platziert werden. Das dwSize-Element der BLUETOOTH_DEVICE_INFO Struktur, auf die pbtdi verweist, muss der Größe der Struktur entsprechen, andernfalls schlägt der Aufruf der BluetoothFindFirstDevice-Funktion fehl.

Rückgabewert

Gibt nach erfolgreicher Fertigstellung ein gültiges Handle für das erste Bluetooth-Gerät zurück, und der pbtdi-Parameter verweist auf Informationen zum Gerät. Wenn dieser Handle nicht mehr benötigt wird, muss er über bluetoothFindDeviceClose geschlossen werden.

Gibt NULL zurück, wenn ein Fehler auftritt. Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zum Fehler zu erhalten. In der folgenden Tabelle werden häufige Fehler beschrieben:

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Der pbtsp - oder pbtdi-Parameter ist NULL.
ERROR_REVISION_MISMATCH	Die Struktur, auf die pbtsp oder pbtdi verweist, ist nicht die richtige Größe.

Hinweise

Die BluetoothFindFirstDevice-Funktion findet keine Bluetooth Low Energy-Geräte (LE). Um auf Bluetooth LE-Geräte zuzugreifen, verwenden Sie die Windows-Runtime Bluetooth Low Energy-APIs. Die Windows-Runtime-APIs für Bluetooth funktionieren sowohl in UWP- als auch in klassischen Desktop-Apps.

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