说明

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 后将其设置为可配对。