BthSSPIOCapabilityRequestNegativeReply (Compact 7)

  • Article

3/12/2014

This function may be called in response to a BTE_SSP_IO_CAPABILITY_REQUEST event to cancel a Bluetooth pairing operation.

Syntax

DWORD BthSSPIOCapabilityRequestNegativeReply(
  __in const BT_ADDR *RemoteDevice,
  __in const BYTE     Reason);

Parameters

  • RemoteDevice
    [in] Pointer to a Bluetooth device address.
  • Reason
    [in] Bluetooth error code.

Return Value

The following table shows the possible return values.

Value Description

ERROR_SUCCESS

Success.

ERROR_INVALID_PARAMETER

Reason is 0x37 (Secure Simple Pairing Not Supported by Host).

Remarks

The application cannot use this function to indicate that the device does not support Secure Simple Pairing, but only to indicate unexpected failures.

If the device does not support Secure Simple Pairing, the application can disable it by using BthSSPSetConfigurationInfo and a BTSSPConfigurationInfo structure with a Flag member that includes BT_SSP_FLAG_BASEBAND_SSP_DISABLE.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API SSP Functions
BthSSPIOCapabilityRequestReply