bt_disc_start_inquiry()

Start scanning for Bluetooth-enabled devices.

Synopsis:

#include <btapi/btdevice.h>

int bt_disc_start_inquiry(const bt_inquiry_access_t access_code)

Since:

BlackBerry 10.0.0

Arguments:

access_code: The type of inquiry to perform.

Library:

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

Description:

A scan of in-range Bluetooth devices is made and the results of the scan can be found via the BT_EVT_DEVICE_ADDED events passed to the device library callback. For information, see the bt_device_init() function or one of the bt_disc_retrieve_*() functions with the BT_DISCOVERY_CACHED option. This function blocks until the inquiry has completed. The Bluetooth service attempts to discover devices when this function is called. When this function unblocks, you can call bt_disc_retrieve_devices() to retrieve the list of devices. This function does not return BT_EVT_DEVICE_ADDED events for paired devices, even if they are in range. The purpose is to discover new, non-paired devices only.

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