說明

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

參數(shù)

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

命令調(diào)用示例

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

可能的返回值

• (0) 成功結(jié)束配對
• (-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í)行的綁定類型）建立的連接。如果使用專用綁定啟動了綁定過程（或設備已斷開連接），則此函數(shù)不起作用。此函數(shù)使用指定要綁定（通用綁定）的遠程藍牙設備的地址。此函數(shù)將終止已建立的 ACL 連接。不會對原始 GAP_Initiate_Bonding 函數(shù)調(diào)用中指定的 GAP 事件回調(diào)發(fā)出 GAP 事件回調(diào)（如果此函數(shù)成功返回）。