This function enables the invoking of a service application when a registered Bluetooth event occurs.


#include <btapi/btdevice.h>
int bt_ldev_enable_invoke(const char *target)


BlackBerry 10.3.0



The target key that is defined in the application manifest.


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


The application is invoked when the first event is received that meets the filtering parameters defined with bt_ldev_set_filters() and the application has been deregistered (exited) or placed in the stop partition. When invoked, the invoke action is bb.action.bluetooth.EVENT. The application can use bt_ldev_invoke_decode_event() to retrieve the event data.

If the application is deregistered or terminated, the invoke setup will remain until the first invoke event is sent or until the application restarts and calls bt_le_init() prior to any invoke event.


EOK on successful enabling the invoke interface, -1 if an error occurred with the errno value set. These are some of the error codes that can be returned:
  • ENOMEM: Sufficient memory is not available to perform the request.
  • EACCES: The current application does not have permission to invoke the supplied trigger.
  • ESRVRFAULT: An internal error has occurred.

Last modified: 2014-06-24

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

comments powered by Disqus