BluetoothSendAuthenticationResponse function (bluetoothapis.h)
The BluetoothSendAuthenticationResponse function is called when an authentication request to send the passkey response is received.
Syntax
DWORD BluetoothSendAuthenticationResponse(
HANDLE hRadio,
const BLUETOOTH_DEVICE_INFO *pbtdi,
LPCWSTR pszPasskey
);
Parameters
hRadio
Optional handle to the local radio handle, or NULL. If NULL, the function attempts to send an authentication response on all local radios.
pbtdi
Pointer to a BLUETOOTH_DEVICE_INFO structure describing the Bluetooth device being authenticated. This can be the same structure passed to the callback function.
pszPasskey
Pointer to a UNICODE zero-terminated string of the passkey response to be sent back to the authenticating device. the pszPasskey parameter can be no larger than BLUETOOTH_MAX_PASSKEY_SIZE, excluding NULL. If translation to ANSI is performed, the pszPasskey parameter cannot be larger than 16 bytes, excluding NULL.
Return value
Returns ERROR_SUCCESS when the device accepts the passkey response; the device is authenticated. Any other return value indicates failure. The following table describes common errors:
| Return code | Description |
|---|---|
|
The Bluetooth device denied the passkey response. This error is also returned if a communication problem exists with the local radio. |
|
The device returned a failure code during authentication. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP2 [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h) |
| Library | Bthprops.lib |
| DLL | bthprops.cpl |
See also
BluetoothAuthenticateMultipleDevices
BluetoothEnableIncomingConnections
BluetoothRegisterForAuthentication