bt_ldev_get_oob_data()

Retrieve the out-of-band (OOB) pairing data of the local device.

Synopsis:

#include <btapi/btdevice.h>
 

int bt_ldev_get_oob_data(const char **hashC, const char **randR)

Since:

BlackBerry 10.1.0

Arguments:

hashC

A pointer to a printable character array containing the Hash-C value from the local device.

randR

A pointer to a printable character array containing the Randomizer-R value from the local device.

Library:

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

Description:

The OOB Hash-C and Randomizer-R values for the local Bluetooth device are copied into the provided character buffers, which can then be passed to the remote device for OOB pairing (see bt_rdev_set_oob_data()).

Returns:

0 is returned upon success, -1 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 hashC or randR.
  • ENOMEM: There was insufficient memory to allocate required structures.
  • ENOENT: A required data entry was not found (internal error)
  • EPERM: There was an error accessing required system data (internal error).
Parent topic: Functions in btdevice.h