bt_gatt_enable_indicate()

Enable indications for a given Generic Attribute (GATT) characteristic.

Synopsis:

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

Since:

BlackBerry 10.0.0

Arguments:

instance

The identifier used to reference the connected primary service.

characteristic

The GATT characteristic.

enable

Enable or disable indications for the specified characteristic. Use a value of 1 to enable indications or a value of 0 to disable them.

Library:

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

Description:

You can also use this function to disable indications for the specified characteristic.

Returns:

EOK when indications have been successfully enabled or disabled, -1 with the errno set otherwise. The error codes that can be returned are as follows:
  • 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