esp_ble_gattc_get_include_service() function

Get the included services with the given service handle in the local GATTC cache.

Syntax

Show:

Summary

Declaration

Definition

from esp_gattc_api.h:617

esp_gatt_status_t esp_ble_gattc_get_include_service(esp_gatt_if_t gattc_if, uint16_t conn_id, uint16_t start_handle, uint16_t end_handle, esp_bt_uuid_t *incl_uuid, esp_gattc_incl_svc_elem_t *result, uint16_t *count);

Implemented in esp_gattc_api.c:374

Arguments

Argument

Description

gattc_if

GATT Client access interface

conn_id

Connection ID which identifies the server

start_handle

The attribute start handle

end_handle

The attribute end handle

incl_uuid

The included service UUID

result

The pointer to the included service with the given service handle.

count

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

Return value

- ESP_OK: Success - ESP_GATT_INVALID_PDU: NULL pointer to `result` or NULL pointer to `count` or the count value is 0 - ESP_FAIL: Failure due to other reasons

Notes

1. This API does not trigger any event. 2. `start_handle` must be greater than 0, and smaller than `end_handle`.

Examples

References

from examples

esp_ble_gattc_get_include_service() function

Syntax

Arguments

Return value

Notes

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle