sd_ble_gatts_include_add()

uint32_t sd_ble_gatts_include_add	(	uint16_t	service_handle,
		uint16_t	inc_srvc_handle,
		uint16_t *	p_include_handle )

#include <ble_gatts.h>

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).

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

Relevant Message Sequence Charts

GATTS ATT Table Population

Parameters

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

Return values

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