Embassy
nrf-softdevice-s122

Crates

git

Versions

default

Flavors

pub unsafe fn sd_ble_gattc_relationships_discover(
conn_handle: u16,
p_handle_range: *const ble_gattc_handle_range_t
) -> u32
Expand description

@brief Initiate or continue a GATT Relationship Discovery procedure.

@details This function initiates or resumes the Find Included Services sub-procedure. If the last included service has not been reached, this must be called again with an updated handle range to continue the search.

@events @event{@ref BLE_GATTC_EVT_REL_DISC_RSP} @endevents

@mscs @mmsc{@ref BLE_GATTC_REL_DISC_MSC} @endmscs

@param[in] conn_handle The connection handle identifying the connection to perform this procedure on. @param[in] p_handle_range A pointer to the range of handles of the Service to perform this procedure on.

@retval ::NRF_SUCCESS Successfully started or resumed the Relationship Discovery procedure. @retval ::BLE_ERROR_INVALID_CONN_HANDLE Invalid Connection Handle. @retval ::NRF_ERROR_INVALID_STATE Invalid Connection State. @retval ::NRF_ERROR_INVALID_ADDR Invalid pointer supplied. @retval ::NRF_ERROR_INVALID_PARAM Invalid parameter(s) supplied. @retval ::NRF_ERROR_BUSY Client procedure already in progress. @retval ::NRF_ERROR_TIMEOUT There has been a GATT procedure timeout. No new GATT procedure can be performed without reestablishing the connection.