bt_disc_retrieve

Retrieve the number of Bluetooth-enabled devices within range.

Synopsis:

#include <btapi/btdevice.h>

int bt_disc_retrieve_count(const int option)

Since:

BlackBerry 10.0.0

Arguments:

option: Specifies whether to return a count of paired (BT_DISCOVERY_PREKNOWN), found (BT_DISCOVERY_CACHED), or connected (BT_DISCOVERY_CONNECTED) devices.

Library:

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

Description:

The number of Bluetooth-enabled devices returned are from either the paired or found devices list. You usually use this function before fetching the actual devices using the bt_disc_retrieve_devices() function.

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: