bt_ldev_set_discoverable()

Set the local Bluetooth-enabled device to discoverable mode.

Synopsis:

#include <btapi/btdevice.h>

int bt_ldev_set_discoverable(const bt_discoverable_t new_mode)

Since:

BlackBerry 10.0.0

Arguments:

new_mode: The new Bluetooth discoverable mode being requested.

Library:

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

Description:

After you set the discoverable mode, you can monitor for the BT_EVT_ACCESS_CHANGED event to confirm that the mode has been changed. The return code for this function indicates that the function has run successfully, not that the discoverable mode has changed.

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:

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).