esp_ble_gattc_get_all_descr() function

Get all descriptors with the given characteristic in the local GATTC cache

Syntax

Show:

Summary

Declaration

Definition

from esp_gattc_api.h:505

esp_gatt_status_t esp_ble_gattc_get_all_descr(esp_gatt_if_t gattc_if, uint16_t conn_id, uint16_t char_handle, esp_gattc_descr_elem_t *result, uint16_t *count, uint16_t offset);

Implemented in esp_gattc_api.c:289

Arguments

Argument

Description

gattc_if

GATT Client access interface

conn_id

Connection ID which identifies the server

char_handle

The given characteristic handle

result

The pointer to the descriptor in the characteristic

count

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

offset

The position offset to retrieve

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_all_descr() is referenced by 3 libraries and example projects:

References

from examples

esp_ble_gattc_get_all_descr() function

Syntax

Arguments

Return value

Notes

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle