BluetoothSendAuthenticationResponseEx function

The BluetoothSendAuthenticationResponseEx function is called when an authentication request to send the passkey or a Numeric Comparison response is made.

Note  This API is supported in Windows Vista SP2 and Windows 7.
 

Syntax

DWORD BluetoothSendAuthenticationResponseEx(
  HANDLE                           hRadioIn,
  PBLUETOOTH_AUTHENTICATE_RESPONSE pauthResponse
);

Parameters

hRadioIn

A handle of the Bluetooth radio device to specify local service information for.

pauthResponse

Pointer to a BLUETOOTH_AUTHENTICATE_RESPONSE structure containing the response to the BTH_REMOTE_AUTHENTICATE_REQUEST event.

Return Value

Returns ERROR_SUCCESS upon successful completion; returns the following error codes upon failure:

Return code Description
ERROR_CANCELLED
The device was denied the passkey response. This may also indicate a communications problem with the local radio device.
E_FAIL
The device returned a failure code during authentication.

Remarks

Callers can only use this function to respond to a pending authentication request. Applications should register with BluetoothRegisterForAuthenticationEx in order to be notified of incoming authentication requests.

Only the BLUETOOTH_AUTHENTICATION_METHOD_LEGACY, BLUETOOTH_AUTHENTICATION_METHOD_NUMERIC_COMPARISON and BLUETOOTH_AUTHENTICATION_METHOD_PASSKEY_NOTIFICATION response types are valid.

Requirements

   
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.dll

See Also

BluetoothSendAuthenticationResponse