bt_rdev_get_services_gatt_connected()

The function retrieves the list of connected Generic Attributes (GATT) services.

Synopsis:

#include <btapi/btdevice.h>
 

char** bt_rdev_get_services_gatt_connected(const bt_remote_device_t *remote_device)

Since:

BlackBerry 10.2.0

Arguments:

remote_device

A pointer to a remote device structure.

Library:

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

Description:

Retrieves an array of connected GATT services for the specified remote device. The following example demonstrates how to use this function:

 char **services_array;
 if( ( services_array =
         bt_rdev_get_services_gatt_connected(remote_device)) != NULL) {
     // work with the services listing
     bt_rdev_free_services(services_array);
 }

Returns:

An allocated array of NULL-terminated strings for connected remote device services is returned upon success, NULL with the errno set otherwise. Any errno value other than the following indicates that a system error has occurred:
  • EINVAL: An invalid value was passed in for remote_device.
  • ENOMEM: There was insufficient memory to allocate required structures.
  • ENOENT: There are no GATT services listed for the remote device.
Parent topic: Functions in btdevice.h