說(shuō)明

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

參數(shù)

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

命令調(diào)用示例

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

可能的返回值

• (0) 成功設(shè)置可配對(duì)性模式
• (-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 說(shuō)明

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