说明

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

参数

PINCodeResponse 命令需要一个参数，即用于对连接进行身份验证的 PIN 码。这是一个字符串值，最长可达 16 位数字。配对发起方查看在配对过程中显示的消息来调用此命令。在发起方输入 PIN 码后，响应方会收到一条调用此命令的消息。

命令调用示例

• “PINCodeResponse 1234”尝试将 PIN 码设置为“1234”。
• “PINCodeResponse 5921302312564542”尝试将 PIN 码设置为“5921302312564542”。该值表示最长的 16 位 PIN 码值。

可能的返回值

• (0) 成功的 PIN 码响应
• (-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 以及身份验证响应信息（由调用方指定）。