說明

EnableSCOnly 命令啟用僅 LE 安全連接 (SC) 模式。如果啟用此模式，則拒絕來自僅支持傳統(tǒng)配對的對等方的配對請求。請注意，如果啟用此模式，LE_Parameters 中的 SC 標(biāo)志必須設(shè)置為 TRUE。此函數(shù)在成功執(zhí)行時(shí)返回零，而在出現(xiàn)任何錯(cuò)誤時(shí)返回負(fù)值。

參數(shù)

此命令需要一個(gè)參數(shù)，該參數(shù)指示是否設(shè)置僅安全連接模式。0 = 僅 SC 模式關(guān)閉，1 = 僅 SC 模式打開。

命令調(diào)用示例

• “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 調(diào)用

GAP_LE_SC_Only_Mode(BluetoothStackID, EnableSCOnly)

API 原型

int BTPSAPI GAP_LE_SC_Only_Mode (unsigned int BluetoothStackID, Boolean_t EnableSCOnly)

API 說明

提供的以下函數(shù)允許配置僅 LE 安全連接模式。上層在 LE SC 配對開始之前使用此函數(shù)，以防止該函數(shù)要求拒絕僅支持傳統(tǒng)配對的設(shè)備。當(dāng)設(shè)備具有高安全性比設(shè)備與不支持 SC 的設(shè)備保持向后兼容性更重要時(shí)，可以使用該模式。和該函數(shù)將以下內(nèi)容作為參數(shù)：藍(lán)牙設(shè)備的藍(lán)牙協(xié)議棧 ID 以及啟用或禁用僅 SC 模式的布爾值 EnableSCOnly。此函數(shù)在第一次配對過程之前使用一次。如果成功，此函數(shù)返回零；否則返回負(fù)的錯(cuò)誤代碼。