sd_ble_gatts_value_get()

uint32_t sd_ble_gatts_value_get	(	uint16_t	conn_handle,
		uint16_t	handle,
		ble_gatts_value_t *	p_value )

#include <ble_gatts.h>

Get the value of a given attribute.

Note

If the attribute value is longer than the size of the supplied buffer, ble_gatts_value_t::len will return the total attribute value length (excluding offset), and not the number of bytes actually returned in ble_gatts_value_t::p_value. The application may use this information to allocate a suitable buffer size.

When retrieving system attribute values with this function, the connection handle may refer to an already disconnected connection. Refer to the documentation of sd_ble_gatts_sys_attr_get for further information.

Parameters

[in]	conn_handle	Connection handle. Ignored if the value does not belong to a system attribute.
[in]	handle	Attribute handle.
[in,out]	p_value	Attribute value information.

Return values

NRF_SUCCESS	Successfully retrieved the value of the attribute.
NRF_ERROR_INVALID_ADDR	Invalid pointer supplied.
NRF_ERROR_NOT_FOUND	Attribute not found.
NRF_ERROR_INVALID_PARAM	Invalid attribute offset supplied.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid connection handle supplied on a system attribute.
BLE_ERROR_GATTS_SYS_ATTR_MISSING	System attributes missing, use sd_ble_gatts_sys_attr_set to set them to a known value.