BluetoothSendAuthenticationResponse-Funktion (bluetoothapis.h)

Artikel
08/22/2023

Die BluetoothSendAuthenticationResponse-Funktion wird aufgerufen, wenn eine Authentifizierungsanforderung zum Senden der Passkeyantwort empfangen wird.

Hinweis Bei der Entwicklung für Windows Vista SP2 und Windows 7 wird die Verwendung von BluetoothSendAuthenticationResponseEx empfohlen.

Syntax

DWORD BluetoothSendAuthenticationResponse(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  LPCWSTR                     pszPasskey
);

Parameter

hRadio

Optionaler Handle zum lokalen Funkhandle oder NULL. Bei NULL versucht die Funktion, eine Authentifizierungsantwort für alle lokalen Funkgeräte zu senden.

pbtdi

Zeiger auf eine BLUETOOTH_DEVICE_INFO Struktur, die das zu authentifizierde Bluetooth-Gerät beschreibt. Dies kann dieselbe Struktur sein, die an die Rückruffunktion übergeben wird.

pszPasskey

Zeiger auf eine UNICODE-Zeichenfolge, die null beendet ist, der Kennungsantwort, die an das authentifizierende Gerät zurückgesendet werden soll. Der parameter pszPasskey darf nicht größer als BLUETOOTH_MAX_PASSKEY_SIZE sein, ausgenommen NULL. Wenn die Übersetzung in ANSI durchgeführt wird, darf der pszPasskey-Parameter nicht größer als 16 Bytes sein, ausgenommen NULL.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn das Gerät die Kennungsantwort akzeptiert. das Gerät wird authentifiziert. Jeder andere Rückgabewert weist auf einen Fehler hin. In der folgenden Tabelle werden häufige Fehler beschrieben:

Rückgabecode	Beschreibung
ERROR_CANCELLED	Das Bluetooth-Gerät verweigerte die Kennungsantwort. Dieser Fehler wird auch zurückgegeben, wenn ein Kommunikationsproblem mit dem lokalen Funkgerät besteht.
E_FAIL	Das Gerät hat während der Authentifizierung einen Fehlercode zurückgegeben.

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