esp_ble_gattc_get_descr_by_uuid() function

Get the descriptor with the given characteristic UUID in the local GATTC cache

Syntax

Show:

Summary

Declaration

Definition

from esp_gattc_api.h:561

esp_gatt_status_t esp_ble_gattc_get_descr_by_uuid(esp_gatt_if_t gattc_if, uint16_t conn_id, uint16_t start_handle, uint16_t end_handle, esp_bt_uuid_t char_uuid, esp_bt_uuid_t descr_uuid, esp_gattc_descr_elem_t *result, uint16_t *count);

Implemented in esp_gattc_api.c:333

Arguments

Argument

Description

gattc_if

GATT Client access interface

conn_id

Connection ID

start_handle

The attribute start handle

end_handle

The attribute end handle

char_uuid

The characteristic UUID

descr_uuid

The descriptor UUID.

result

The pointer to the descriptor in the given characteristic.

count

The number of descriptors want to retrieve. It will be updated with the actual number of descriptors 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_descr_by_uuid() function

Syntax

Arguments

Return value

Notes

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle