Retrieve the list of connected services for a remote device.
Synopsis:
#include <btapi/btdevice.h>
char** bt_rdev_get_services_connected(const bt_remote_device_t *remote_device)
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 services for the specified remote device. The following example shows you how to retrieve a list of connected remote device services:
char **services_array;
if( ( services_array = bt_rdev_get_services_connected( remote_device ) ) != NULL)
{
//work with the services listing
bt_rdev_free_services( services_array );
}
Returns:
An allocated, NULL-terminated array of connected remote device service strings 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 (regular) services listed for the remote device.