说明

要使用 OOB 方法执行 LE SC 配对，请在配对过程开始之前生成本地随机值和确认值。以下函数允许用户生成 OOB 本地参数。该函数不得在配对过程中使用。这仅适用于 LE SC 配对。此函数在成功执行时返回零，而在出现任何错误时返回负值。

参数

无需任何参数。

命令调用示例

“SCGenerateOOBLocalParams”尝试在配对过程开始前生成本地随机值和确认值。

可能的返回值

• (0) 成功。
• (-4) FUNCTION_ERROR。
• (-8) INVALID_STACK_ID_ERROR。
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID。
• (-56) BTPS_ERROR_GAP_NOT_INITIALIZED。
• (-104) BTPS_ERROR_LOCAL_CONTROLLER_DOES_NOT_SUPPORT_LE。
• (-117) BTPS_ERROR_PAIRING_ACTIVE。
• (-120) BTPS_ERROR_FEATURE_NOT_CURRENTLY_ACTIVE。

API 调用

GAP_LE_SC_OOB_Generate_Parameters(BluetoothStackID, &OOBLocalRandom, &OOBLocalConfirmation)

API 原型

int BTPSAPI GAP_LE_SC_OOB_Generate_Parameters(unsigned int BluetoothStackID, SM_Random_Value_t *OOB_Local_Rand_Result, SM_Confirm_Value_t*OOB_Local_Confirm_Result)

API 说明

提供以下函数是为了能够在带外 (OOB) 关联方法中使用 LE 安全连接 (SC) 配对。上层使用此函数生成蓝牙规范中定义的本地 OOB 随机值和 OOB 确认值（ra/rb 和 Ca/Cb）。该函数将以下内容作为参数：蓝牙设备的蓝牙协议栈 ID 以及指向缓冲区的指针（用于接收生成的本地 OOB 随机值和 OOB 确认值）。如果成功，此函数返回零；否则返回负的错误代码。