BluetoothFindNextDevice-Funktion (bluetoothapis.h)

Artikel
02/23/2024

Die BluetoothFindNextDevice-Funktion sucht das nächste Bluetooth-Gerät.

Syntax

BOOL BluetoothFindNextDevice(
  HBLUETOOTH_DEVICE_FIND hFind,
  BLUETOOTH_DEVICE_INFO  *pbtdi
);

Parameter

hFind

Handle für die Abfrage, die bei einem vorherigen Aufruf der BluetoothFindFirstDevice-Funktion abgerufen wurde.

pbtdi

Zeiger auf eine BLUETOOTH_DEVICE_INFO Struktur, in der Informationen über das nächste gefundene Bluetooth-Gerät platziert werden. Der dwSize-Member der BLUETOOTH_DEVICE_INFO Struktur, auf die pbtdi verweist, muss der Größe der Struktur entsprechen, andernfalls schlägt der Aufruf von BluetoothFindNextDevice fehl.

Rückgabewert

Gibt TRUE zurück, wenn das nächste Gerät erfolgreich gefunden wurde und der pbtdi-Parameter auf Informationen zum Gerät verweist. Gibt FALSE bei Einem Fehler zurück. 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_HANDLE	Das Handle ist NULL.
ERROR_NO_MORE_ITEMS	Es wurden keine weiteren Geräte gefunden.
ERROR_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

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