说明

EnableSCOnly 命令启用仅 LE 安全连接 (SC) 模式。如果启用此模式，则拒绝来自仅支持传统配对的对等方的配对请求。请注意，如果启用此模式，LE_Parameters 中的 SC 标志必须设置为 TRUE。此函数在成功执行时返回零，而在出现任何错误时返回负值。

参数

此命令需要一个参数，该参数指示是否设置仅安全连接模式。0 = 仅 SC 模式关闭，1 = 仅 SC 模式打开。

命令调用示例

• “EnableSCOnly 0”禁用仅安全连接模式。
• “EnableSCOnly 1”启用仅安全连接模式。

可能的返回值

• (0) 成功。
• (-4) FUNCTION_ERROR。
• (-6) INVALID_PARAMETERS_ERROR。
• (-8) INVALID_STACK_ID_ERROR。
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID。
• (-56) BTPS_ERROR_GAP_NOT_INITIALIZED。
• (-103) BTPS_ERROR_FEATURE_NOT_AVAILABLE。
• (-104) BTPS_ERROR_LOCAL_CONTROLLER_DOES_NOT_SUPPORT_LE。
• (-120) BTPS_ERROR_FEATURE_NOT_CURRENTLY_ACTIVE。

API 调用

GAP_LE_SC_Only_Mode(BluetoothStackID, EnableSCOnly)

API 原型

int BTPSAPI GAP_LE_SC_Only_Mode (unsigned int BluetoothStackID, Boolean_t EnableSCOnly)

API 说明

提供的以下函数允许配置仅 LE 安全连接模式。上层在 LE SC 配对开始之前使用此函数，以防止该函数要求拒绝仅支持传统配对的设备。当设备具有高安全性比设备与不支持 SC 的设备保持向后兼容性更重要时，可以使用该模式。和该函数将以下内容作为参数：蓝牙设备的蓝牙协议栈 ID 以及启用或禁用仅 SC 模式的布尔值 EnableSCOnly。此函数在第一次配对过程之前使用一次。如果成功，此函数返回零；否则返回负的错误代码。