說明

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

參數

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

命令調用示例

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

可能的返回值

• (0) 成功設置可配對性模式
• (-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 調用

GAP_Set_Pairability_Mode(BluetoothStackID, PairabilityMode)

API 原型

int BTPSAPI GAP_Set_Pairability_Mode(unsigned int BluetoothStackID, GAP_Pairability_Mode_t GAP_Pairability_Mode)

API 說明

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