sd_ble_gatts_rw_authorize_reply()

uint32_t sd_ble_gatts_rw_authorize_reply	(	uint16_t	conn_handle,
		ble_gatts_rw_authorize_reply_params_t const *	p_rw_authorize_reply_params )

#include <ble_gatts.h>

Respond to a Read/Write authorization request.

Note

This call should only be used as a response to a BLE_GATTS_EVT_RW_AUTHORIZE_REQUEST event issued to the application.

Relevant Message Sequence Charts

GATTS Queued Writes: App handled, one or more attributes require authorization

GATTS Queued Writes: Stack handled, one or more attributes require authorization

GATTS Queued Writes: App handled, no attributes require authorization

GATTS Read Request with Authorization

GATTS Write Request with Authorization

GATTS Queued Writes: Prepare Queue Full

GATTS Queued Writes: Peer cancels operation

Parameters

[in]	conn_handle	Connection handle.
[in]	p_rw_authorize_reply_params	Pointer to a structure with the attribute provided by the application.

Note

ble_gatts_authorize_params_t::p_data is ignored when this function is used to respond to a BLE_GATTS_AUTHORIZE_TYPE_READ event if ble_gatts_authorize_params_t::update is set to 0.

Return values

NRF_SUCCESS	Successfully queued a response to the peer, and in the case of a write operation, Attribute Table updated.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid Connection Handle.
NRF_ERROR_BUSY	The stack is busy, process pending events and retry.
NRF_ERROR_INVALID_ADDR	Invalid pointer supplied.
NRF_ERROR_INVALID_STATE	Invalid Connection State or no authorization request pending.
NRF_ERROR_INVALID_PARAM	Authorization op invalid, handle supplied does not match requested handle, or invalid data to be written provided by the application.
NRF_ERROR_TIMEOUT	There has been a GATT procedure timeout. No new GATT procedure can be performed without reestablishing the connection.