bt_rdev_get_friendly_name()

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:
  • EINVAL: An invalid parameter was passed in.

Last modified: 2014-05-14



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

comments powered by Disqus