bt_rdev_get_remote_name()

Retrieve the remote device name.

Synopsis:

#include <btapi/btdevice.h>

int bt_rdev_get_remote_name(const bt_remote_device_t *remote_device, char *device_name, const int device_name_len)

Since:

BlackBerry 10.2.0

Arguments:

remote_device: A pointer to a remote device structure.

device_name: A buffer where the name of the remote Bluetooth device is written.

device_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:

This function retrieves the remote name of the Bluetooth-enabled device. The remote name is the name which the remote device advertises.

Returns:

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

EINVAL: An invalid parameter was passed in.