bt_rdev_get_friendly

Retrieve the remote device friendly name.

Synopsis:

#include <btapi/btdevice.h>

int bt_rdev_get_friendly_name(const bt_remote_device_t *remote_device, char *friendly_name, const int friendly_name_len)

Since:

BlackBerry 10.0.0

Arguments:

remote_device: A pointer to a remote device structure.

friendly_name: A buffer where the Bluetooth friendly name is written.

friendly_name_len: The size of the buffer. The minimum size is 2 bytes and the maximum is 256 bytes. The buffer length must include room for the terminating NULL character.

Library:

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

Description:

Requests the friendly name of the remote Bluetooth-enabled device. The friendly name is usually the same as the remote name, but it can be customized by the user on the BlackBerry.

Returns:

0 is returned upon success, -1 with the errno set otherwise. Possible errno values include: