BluetoothSendAuthenticationResponseEx-Funktion (bluetoothapis.h)

Artikel
02/23/2024

Die BluetoothSendAuthenticationResponseEx-Funktion wird aufgerufen, wenn eine Authentifizierungsanforderung zum Senden des Schlüssels oder eine Numerische Vergleichsantwort erfolgt.

Hinweis Diese API wird in Windows Vista SP2 und Windows 7 unterstützt.

Syntax

DWORD BluetoothSendAuthenticationResponseEx(
  [in, optional] HANDLE                           hRadioIn,
  [in]           PBLUETOOTH_AUTHENTICATE_RESPONSE pauthResponse
);

Parameter

[in, optional] hRadioIn

Ein Handle des Bluetooth-Funkgeräts, für das lokale Dienstinformationen angegeben werden sollen.

[in] pauthResponse

Zeiger auf eine BLUETOOTH_AUTHENTICATE_RESPONSE-Struktur , die die Antwort auf das BTH_REMOTE_AUTHENTICATE_REQUEST-Ereignis enthält.

Rückgabewert

Gibt nach erfolgreichem Abschluss ERROR_SUCCESS zurück. gibt bei Einem Fehler die folgenden Fehlercodes zurück:

Rückgabecode	Beschreibung
ERROR_CANCELLED	Dem Gerät wurde die Kennungsantwort verweigert. Dies kann auch auf ein Kommunikationsproblem mit dem lokalen Funkgerät hinweisen.
E_FAIL	Das Gerät hat während der Authentifizierung einen Fehlercode zurückgegeben.

Hinweise

Aufrufer können diese Funktion nur verwenden, um auf eine ausstehende Authentifizierungsanforderung zu reagieren. Anwendungen sollten sich bei BluetoothRegisterForAuthenticationEx registrieren, um über eingehende Authentifizierungsanforderungen benachrichtigt zu werden.

Nur die Antworttypen BLUETOOTH_AUTHENTICATION_METHOD_LEGACY, BLUETOOTH_AUTHENTICATION_METHOD_NUMERIC_COMPARISON und BLUETOOTH_AUTHENTICATION_METHOD_PASSKEY_NOTIFICATION sind gültig.

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

Weitere Informationen

BluetoothSendAuthenticationResponse

Freigeben über