esp_ble_gattc_get_service() function

Get the service with the given service UUID in the local GATTC cache

Syntax

Show:

Summary

Declaration

Definition

esp_gatt_status_t esp_ble_gattc_get_service(esp_gatt_if_t gattc_if, uint16_t conn_id, esp_bt_uuid_t *svc_uuid, esp_gattc_service_elem_t *result, uint16_t *count, uint16_t offset);

Argument

Description

gattc_if

GATT Client access interface

conn_id

Connection ID

svc_uuid

The pointer to the service UUID. If NULL is passed, the API will retrieve all services.

result

The pointer to the service which has been found in the local GATTC cache

count

The number of services to retrieve. It will be updated with the actual number of services found.

offset

The position offset to retrieve

- ESP_OK: Success - ESP_FAIL: Failure

1. This API does not trigger any event. 2. `esp_ble_gattc_cache_refresh` can be used to discover services again.

from examples