Function nrf_softdevice_s112::sd_ble_gap_sec_info_reply
source · pub unsafe fn sd_ble_gap_sec_info_reply(
conn_handle: u16,
p_enc_info: *const ble_gap_enc_info_t,
p_id_info: *const ble_gap_irk_t,
p_sign_info: *const ble_gap_sign_info_t
) -> u32
Expand description
@brief Reply with GAP security information.
@details This function is only used to reply to a @ref BLE_GAP_EVT_SEC_INFO_REQUEST, calling it at other times will result in @ref NRF_ERROR_INVALID_STATE. @note If the call returns an error code, the request is still pending, and the reply call may be repeated with corrected parameters. @note Data signing is not yet supported, and p_sign_info must therefore be NULL.
@mscs @mmsc{@ref BLE_GAP_PERIPH_ENC_MSC} @endmscs
@param[in] conn_handle Connection handle. @param[in] p_enc_info Pointer to a @ref ble_gap_enc_info_t encryption information structure. May be NULL to signal none is available. @param[in] p_id_info Pointer to a @ref ble_gap_irk_t identity information structure. May be NULL to signal none is available. @param[in] p_sign_info Pointer to a @ref ble_gap_sign_info_t signing information structure. May be NULL to signal none is available.
@retval ::NRF_SUCCESS Successfully accepted security information. @retval ::NRF_ERROR_INVALID_PARAM Invalid parameter(s) supplied. @retval ::NRF_ERROR_INVALID_STATE Invalid state to perform operation. Either: - No link has been established. - No @ref BLE_GAP_EVT_SEC_REQUEST pending. - Encryption information provided by the app without being requested. See @ref ble_gap_evt_sec_info_request_t::enc_info. @retval ::BLE_ERROR_INVALID_CONN_HANDLE Invalid connection handle supplied.