bt_rdev_set_oob_data()

Set out-of-band (OOB) pairing data for a remote Bluetooth-enabled device.

Synopsis:

#include <btapi/btdevice.h>
 
int bt_rdev_set_oob_data(const bt_remote_device_t *remote_device, const char *hashC, const char *randR, const int psi, const int role)

Since:

BlackBerry 10.1.0

Arguments:

remote_device

A pointer to a remote device structure.

hashC

A printable character array containing the Hash-C value from the remote device.

randR

A printable character array containing the Randomizer-R value from the remote device.

psi

The page scan information (PSI) clock offset value (optional, use -1 if unspecified).

role

The OOB pairing role that this side is taking (optional, see BT_OOB_ROLE_*).

Library:

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

Description:

Use this function to save OOB authentication (pairing) data. To initiate the OOB pairing, simply call bt_rdev_pair() after calling 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 remote_device.
  • 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).

Last modified: 2014-05-14



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

comments powered by Disqus