说明

EndPairing 命令负责结束先前启动的与远程设备的绑定会话。此函数在成功执行时返回零，而在出现任何错误时返回负值。尝试结束配对之前，必须存在蓝牙协议栈 ID，并且该设备必须已连接至一个远程设备。还需要注意的是，调用 EndPairing 之前必须使用 Pair 命令和 Inquiry 命令才能断开与远程设备的连接。

参数

EndPairing 命令需要一个参数，即远程蓝牙设备的查询索引。该值可以在查询后找到，或者在使用命令 DisplayInquiryList 时显示。除非配对后调用了新的查询，否则该值与 Pair 命令中使用的第一个参数的值相同。如果是这种情况，请找到 Pair 命令中使用的设备的蓝牙地址。

命令调用示例

• “EndPairing 5”尝试结束与第五个查询索引处的远程设备的配对。
• “EndPairing 8”尝试结束与第八个查询索引处的远程设备的配对。

可能的返回值

• (0) 成功结束配对
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-58) BTPS_ERROR_INVALID_MODE
• (-4) FUNCTION_ERROR
• (-6) INVALID_PARAMETERS_ERROR
• (-8) INVALID_STACK_ID_ERROR

API 调用

GAP_End_Bonding(BluetoothStackID, InquiryResultList[(TempParam->Params[0].intParam – 1)]);

API 原型

int BTPSAPI GAP_Initiate_Bonding(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_Bonding_Type_t GAP_Bonding_Type, GAP_Event_Callback_tGAP_Event_Callback, unsigned long CallbackParameter);

API 说明

提供此函数是为了能够终止通过调用 GAP_Initiate_Bonding 函数（指定通用绑定作为待执行的绑定类型）建立的连接。如果使用专用绑定启动了绑定过程（或设备已断开连接），则此函数不起作用。此函数使用指定要绑定（通用绑定）的远程蓝牙设备的地址。此函数将终止已建立的 ACL 连接，并且不会向原始 GAP_Initiate_Bonding 函数调用中指定的 GAP 事件回调发出任何 GAP 事件回调（如果此函数返回成功结果）。