說明

EndPairing 命令負(fù)責(zé)結(jié)束先前啟動(dòng)的與遠(yuǎn)程設(shè)備的綁定會(huì)話。此函數(shù)在成功執(zhí)行時(shí)返回零，而在出現(xiàn)任何錯(cuò)誤時(shí)返回負(fù)值。嘗試結(jié)束配對(duì)之前，必須存在藍(lán)牙協(xié)議棧 ID，并且該設(shè)備必須已連接至一個(gè)遠(yuǎn)程設(shè)備。還需要注意的是，調(diào)用 EndPairing 之前必須使用 Pair 命令和 Inquiry 命令才能斷開與遠(yuǎn)程設(shè)備的連接。

參數(shù)

EndPairing 命令需要一個(gè)參數(shù)，即遠(yuǎn)程藍(lán)牙設(shè)備的查詢索引。該值可以在查詢后找到，或者在使用命令 DisplayInquiryList 時(shí)顯示。除非配對(duì)后調(diào)用了新的查詢，否則該值與 Pair 命令中使用的第一個(gè)參數(shù)的值相同。如果是這種情況，請(qǐng)找到 Pair 命令中使用的設(shè)備的藍(lán)牙地址。

命令調(diào)用示例

• “EndPairing 5”嘗試結(jié)束與第五個(gè)查詢索引處的遠(yuǎn)程設(shè)備的配對(duì)。
• “EndPairing 8”嘗試結(jié)束與第八個(gè)查詢索引處的遠(yuǎn)程設(shè)備的配對(duì)。

可能的返回值

• (0) 成功結(jié)束配對(duì)
• (-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 調(diào)用

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 說明

提供此函數(shù)是為了能夠終止通過調(diào)用 GAP_Initiate_Bonding 函數(shù)（指定通用綁定作為待執(zhí)行的綁定類型）建立的連接。如果使用專用綁定啟動(dòng)了綁定過程（或設(shè)備已斷開連接），則此函數(shù)不起作用。此函數(shù)使用指定要綁定（通用綁定）的遠(yuǎn)程藍(lán)牙設(shè)備的地址。此函數(shù)將終止已建立的 ACL 連接，并且不會(huì)向原始 GAP_Initiate_Bonding 函數(shù)調(diào)用中指定的 GAP 事件回調(diào)發(fā)出任何 GAP 事件回調(diào)（如果此函數(shù)返回成功結(jié)果）。