BluetoothAuthenticateMultipleDevices-Funktion (bluetoothapis.h)

Artikel
08/22/2023

Mit der BluetoothAuthenticateMultipleDevices-Funktion kann der Aufrufer während einer einzelnen instance des Bluetooth-Verbindungs-Assistenten zur Authentifizierung mehrerer Geräte auffordern.

HinweisBluetoothAuthenticateMultipleDevices ist veraltet. Die Implementierung dieser API wird nicht empfohlen.

Syntax

DWORD BluetoothAuthenticateMultipleDevices(
  HWND                  hwndParent,
  HANDLE                hRadio,
  DWORD                 cDevices,
  BLUETOOTH_DEVICE_INFO *rgbtdi
);

Parameter

hwndParent

Ein Fenster, das das übergeordnete Fenster des Authentifizierungs-Assistenten sein soll. Wenn dieser Wert auf NULL festgelegt ist, wird der Assistent vom Desktop übergeordnet.

hRadio

Das gültige lokale Funkhandle oder NULL. Wenn NULL, wird die Authentifizierung für alle lokalen Funkgeräte versucht. Wenn ein Funk erfolgreich ist, ist der Funktionsaufruf erfolgreich.

cDevices

Die Anzahl der Geräte im pbtdi-Array von BLUETOOTH_DEVICE_INFO Strukturen.

rgbtdi

Ein Array von BLUETOOTH_DEVICE_INFO Strukturen, die Datensätze für die zu authentifizierden Bluetooth-Geräte enthalten.

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück. Überprüfen Sie das fAuthenticate-Flag für jedes Gerät.

In der folgenden Tabelle sind häufige Fehler aufgeführt.

Rückgabecode	Beschreibung
ERROR_CANCELLED	Der Benutzer hat den Vorgang abgebrochen. Überprüfen Sie das fAuthenticate-Flag für jedes Bluetooth-Gerät, um festzustellen, ob Geräte authentifiziert wurden, bevor der Benutzer den Vorgang abgebrochen hat.
ERROR_INVALID_PARAMETER	Mindestens eines der Geräte im pbtdi-Array war ungültig.
ERROR_NO_MORE_ITEMS	Alle Geräte, auf die von pbtdi verwiesen wird, sind bereits als authentifiziert gekennzeichnet.

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