bt_gatt_descriptors_count()

Perform a Generic Attribute (GATT) call to retrieve the number of descriptors for a provided characteristic.

Synopsis:

#include <btapi/btgatt.h>
 
int bt_gatt_descriptors_count(int instance, const bt_gatt_characteristic_t *characteristic)

Since:

BlackBerry 10.0.0

Arguments:

instance

The identifier used to reference the connected primary service.

characteristic

The characteristic to retrieve a count on.

Library:

libbtapi (For the qcc command, use the -l btapi option to link against this library)

Description:

You must provide the characteristic using the characteristic argument. You can retrieve information about the characteristic from the bt_gatt_characteristic_t structure.

Returns:

The number of descriptors that are available, -1 with the errno set otherwise. The error codes that can be returned are as follows:
  • EACCESS: Insufficient authentication or authorization.
  • EBUSY: The stack was busy performing another operation. You can try again later.
  • EDEADLK: A potential deadlock has been avoided.
  • EINVAL: The arguments passed are invalid or the connection to the remote Bluetooth-enabled device is unavailable.
  • ENODEV: Unable to find the service connection defined by the instance argument.
  • ENOMEM: Insufficient memory to perform the request.
  • ENOSYS: The operation failed at the stack level.
  • EPROTO: The operation failed because the response from remote Bluetooth-enabled device had a protocol error.
  • ESRCH: The service connection was not available.
  • ESRVRFAULT: An internal error has occurred.

Last modified: 2014-05-14



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus