BLE_DM_ProceedSecurity

C

uint16_t BLE_DM_ProceedSecurity(uint16_t connHandle, bool repairing);

Description

Proceed the security process.

Note

For Central role, BLE_DM will call BLE_GAP_EnableEncryption API to initiate encryption procedure if paired information recorded in the PDS for peer connected device. Otherwise BLE_SMP_InitiatePairing API will be called by BLE_DM to start pairing procedure.

For Peripheral role, BLE DM call BLE_SMP_InitiatePairing API to trigger SMP security request. It is up to the remote Central then to initiate pairing or encryption procedure.

Parameters

ParameterDescription
[in] connHandleConnection handle associated with this connection.
[in] repairingWhether to force a pairing procedure even if there is an existing pairing record. This argument is only for the Central role. Set true to enable repairing, otherwise set false.

Return values

Return valueDescription
MBA_RES_SUCCESSSuccessfully build configuration.
MBA_RES_OOMInternal memory allocation failure.
MBA_RES_INVALID_PARAThe connHandle is invalid.