GATTC_DiscoverAllPrimaryServices
C
uint16_t GATTC_DiscoverAllPrimaryServices(uint16_t connHandle);Description
Initiates the discovery of all primary services on the connected GATT server.
Note
The discovery process may result in multiple events indicating the status of the discovery until all services are found.
Events generated
GATTC_EVT_DISC_PRIM_SERV_RESP indicates ongoing discovery or finalization of the process.
GATTC_EVT_ERROR_RESP indicates an error or the end of the discovery process if the last service's end handle is less than 0xFFFF.
ATT_EVT_TIMEOUT indicates a timeout waiting for the server's response.
Parameters
| Parameter | Description |
|---|---|
| [in] connHandle | Handle of the connection to discover the services for. |
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. |