說明

SetPairabilityMode 命令負責設(shè)置本地設(shè)備的可配對性模式。此命令在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負值。必須存在藍牙協(xié)議棧 ID，才能嘗試調(diào)用此函數(shù)。

參數(shù)

此命令只需要一個表示可配對性模式的整數(shù)值參數(shù)。該值必須指定為 0（表示不可配對）、1（表示可配對）或 2（表示安全簡易配對）。

命令調(diào)用示例

• “SetPairabilityMode 0”嘗試將本地設(shè)備的可配對性模式設(shè)置為不可配對。
• “SetPairabilityMode 1”嘗試將本地設(shè)備的可配對性模式設(shè)置為可配對。
• “SetPairabilityMode 2”嘗試將本地設(shè)備的可配對性模式設(shè)置為安全簡易配對。

可能的返回值

• (0) 成功設(shè)置可配對性模式
• (-4) FUNCTION_ERROR
• (-6) INVALID_PARAMETERS_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-5) BTPS_ERROR_GAP_NOT_INITIALIZED
• (-58) BTPS_ERROR_INVALID_MODE

API 調(diào)用

GAP_Set_Pairability_Mode(BluetoothStackID, PairabilityMode)

API 原型

int BTPSAPI GAP_Set_Pairability_Mode(unsigned int BluetoothStackID, GAP_Pairability_Mode_t GAP_Pairability_Mode)

API 說明

提供此函數(shù)是為了設(shè)置本地藍牙設(shè)備的可配對性模式。第二個參數(shù)指定要將本地藍牙設(shè)備置于的可配對性模式。如果指定了安全簡易配對 (SSP) 配對模式，則*必須*將 SSP 用于所有配對操作。在此之后，可將設(shè)備置于不可配對模式，但如果重新啟用配對，則*必須*在啟用 SSP 后將其設(shè)置為可配對。