GATTC_DiscoverAllCharacteristics
C
uint16_t GATTC_DiscoverAllCharacteristics(uint16_t connHandle, uint16_t startHandle, uint16_t endHandle);Description
Starts the discovery of all characteristics within a specified handle range on the GATT server.
Note
The discovery may result in multiple events as characteristics are found.
Events generated
GATTC_EVT_ERROR_RESP indicates ongoing discovery or finalization of the process.
GATTC_EVT_DISC_CHAR_RESP indicates an error or the end of the discovery process if no characteristics are found or the last characteristic's value handle does not match the end handle.
ATT_EVT_TIMEOUT indicates a timeout waiting for the server's response.
Parameters
| Parameter | Description |
|---|---|
| [in] connHandle | Handle of the connection to discover the characteristics for. |
| [in] startHandle | Start of the handle range for discovery. |
| [in] endHandle | End of the handle range for discovery. |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Discovery process successfully started. |
| 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. |