esp_ble_gattc_get_descr_by_char_handle() function

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

Syntax

Show:

Summary

Declaration

Definition

from esp_gattc_api.h:590

esp_gatt_status_t esp_ble_gattc_get_descr_by_char_handle(esp_gatt_if_t gattc_if, uint16_t conn_id, uint16_t char_handle, esp_bt_uuid_t descr_uuid, esp_gattc_descr_elem_t *result, uint16_t *count);

Implemented in esp_gattc_api.c:352

Arguments

Argument

Description

gattc_if

GATT Client access interface

conn_id

Connection ID which identifies the server

char_handle

The characteristic handle

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_HANDLE: Invalid GATT `char_handle` - 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. `char_handle` must be greater than 0.

Examples

esp_ble_gattc_get_descr_by_char_handle() is referenced by 4 libraries and example projects:

References

from examples

esp_ble_gattc_get_descr_by_char_handle() function

Syntax

Arguments

Return value

Notes

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle