BthGetBasebandHandles (Compact 2013)

3/26/2014

This function retrieves handles of all current connections.

Syntax

int BthGetBasebandHandles(
  int cHandles,
  unsigned short *pHandles,
  int *pcHandlesReturned
);

Parameters

  • cHandles
    [in] The number of handles in the pHandles buffer.
  • pHandles
    [out] Pointer to an array of handles.
  • pcHandlesReturned
    [out] Pointer to the number of handles returned.

Return Value

The following table shows the possible return values.

Value

Description

ERROR_SUCCESS

Success.

ERROR_INSUFFICIENT_BUFFER

The buffer is too small. pcHandlesReturned contains the required size of the array.

ERROR_NOT_FOUND

An active ACL connection to the peer device that is specified by the Bluetooth address does not exist.

ERROR_SERVICE_NOT_ACTIVE

The Bluetooth stack is not present.

Other standard HRESULT error codes may be returned as appropriate.

Remarks

This function is equivalent to sending the BTH_HCI_IOCTL_GET_BASEBAND_HANDLES HCI IOCTL message.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API Management Functions
Bluetooth AG Service Functions
BthGetBasebandConnections