说明

UserConfirmationResponse 命令负责发出 GAP 身份验证响应，通过输入参数指定其用户确认值。此函数在成功执行时返回零，而在出现任何错误时返回负值。必须存在蓝牙协议栈 ID，才能尝试调用此函数。该设备还必须正在进行由本地设备或远程设备启动的配对操作。

参数

UserConfirmationResponse 命令需要一个参数，即用于对连接进行身份验证的用户确认值。这是一个整数值，必须为 1（以确认连接）或为 0（以不确认身份验证并停止配对过程）。

命令调用示例

• “UserConfirmationResponse 0”尝试拒绝与远程蓝牙设备建立的连接并取消身份验证过程。
• “UserConfirmationResponse 1”尝试接受与远程蓝牙设备建立的连接并确认身份验证过程。

可能的返回值

• (0) 成功的用户确认响应
• (-4) FUNCTION_ERROR
• (-6) INVALID_PARAMETERS_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 调用

GAP_Authentication_Response(BluetoothStackID, CurrentRemoteBD_ADDR, &GAP_Authentication_Information)

API 原型

int BTPSAPI GAP_Authentication_Response(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_Authentication_Information_t *GAP_Authentication_Information)

API 说明

提供此函数是为了能够让本地设备响应 GAP 身份验证事件。此函数用于为指定的蓝牙设备指定身份验证信息。该函数将以下内容作为输入：已请求身份验证操作的蓝牙设备的蓝牙协议栈 ID 以及身份验证响应信息（由调用方指定）。