Embassy
nrf-softdevice-s112

Crates

git

Versions

default

Flavors

pub unsafe fn sd_ble_gatts_include_add(
service_handle: u16,
inc_srvc_handle: u16,
p_include_handle: *mut u16
) -> u32
Expand description

@brief Add an include declaration to the Attribute Table.

@note It is currently only possible to add an include declaration to the last added service (i.e. only sequential population is supported at this time).

@note The included service must already be present in the Attribute Table prior to this call.

@mscs @mmsc{@ref BLE_GATTS_ATT_TABLE_POP_MSC} @endmscs

@param[in] service_handle Handle of the service where the included service is to be placed, if @ref BLE_GATT_HANDLE_INVALID is used, it will be placed sequentially. @param[in] inc_srvc_handle Handle of the included service. @param[out] p_include_handle Pointer to a 16-bit word where the assigned handle will be stored.

@retval ::NRF_SUCCESS Successfully added an include declaration. @retval ::NRF_ERROR_INVALID_ADDR Invalid pointer supplied. @retval ::NRF_ERROR_INVALID_PARAM Invalid parameter(s) supplied, handle values need to match previously added services. @retval ::NRF_ERROR_INVALID_STATE Invalid state to perform operation, a service context is required. @retval ::NRF_ERROR_NOT_SUPPORTED Feature is not supported, service_handle must be that of the last added service. @retval ::NRF_ERROR_FORBIDDEN Forbidden value supplied, self inclusions are not allowed. @retval ::NRF_ERROR_NO_MEM Not enough memory to complete operation. @retval ::NRF_ERROR_NOT_FOUND Attribute not found.