Pair with a remote Bluetooth-enabled device asynchronously.
Synopsis:
#include <btapi/btdevice.h>
int bt_rdev_pair_async(const bt_remote_device_t *remote_device, bt_rdev_pair_cb cb, void *user_data)
Arguments:
- remote_device
-
A pointer to a remote device structure.
- cb
-
The callback function to be executed when the operation has completed.
- user_data
-
A user specified pointer which will be returned during the callback.
Library:
libbtapi (For the qcc command, use the -l btapi option to link against this library)
Description:
This function sends an authentication (pairing) request to the remote device. A Bluetooth device that does not support pairing is flagged as a known device.
Returns:
0 is returned upon successful pairing,
-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).
- ECANCELED: The pairing was canceled or rejected.