bt_disc_retrieve_count()

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:
  • EINVAL: An invalid option was passed in.

Last modified: 2014-05-14



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

comments powered by Disqus