GATTC_ReadUsingUUID

C

uint16_t GATTC_ReadUsingUUID(uint16_t connHandle, GATTC_ReadByTypeParams_T *p_readParams);

Description

Initiates a read operation for a characteristic value by UUID within a handle range.

Note

This function starts a read operation for the value of a characteristic specified by UUID within the given handle range. The operation may result in a series of events indicating the status and results of the read operation.

Events generated

GATTC_EVT_ERROR_RESP indicates a failure to read the characteristic value.

GATTC_EVT_READ_USING_UUID_RESP indicates a successful read operation.

ATT_EVT_TIMEOUT indicates a timeout occurred because the server did not respond to the request.

Parameters


Parameter	Description
[in] connHandle	Handle of the connection to read characteristic value for.
[in] p_readParams	Pointer to structure containing the UUID of the Characteristic and handle range to be queried. See GATTC_ReadByTypeParams_T.

Return values


Return value	Description
MBA_RES_SUCCESS	Read operation successfully initiated.
MBA_RES_OOM	Memory allocation failure occurred internally.
MBA_RES_INVALID_PARA	Invalid parameters, such as an invalid connection handle.
MBA_RES_BUSY	GATT Client is busy with another ongoing request.