BthPerformInquiry (Compact 2013)

3/26/2014

This function performs an inquiry operation.

Syntax

int BthPerformInquiry(
  unsigned int LAP,
  unsigned char length,
  unsigned char num_responses,
  unsigned int cElems,
  unsigned int *pcDiscoveredDevices,
  BthInquiryResult *InquiryList
);

Parameters

  • LAP
    [in] LAP code. For a general inquiry, use the GIAC LAP code (0x9e8b33). For more information about LAP codes, see the Core Specification v2.1 + EDR on the Bluetooth website.
  • length
    [in] The inquiry length, in 1.28 sec intervals.
  • num_responses
    [in] The maximum number of responses to consider before the inquiry completes. To consider unlimited responses, use zero (0).
  • cElems
    [in] The number of elements in the InquiryList array.
  • pcDiscoveredDevices
    [out] The number of devices returned during the inquiry process. If pcDiscoveredDevices is greater than cBuffer, then only the cBuffer results are returned in InquiryList.
  • InquiryList
    [in] Pointer to the output buffer.

Return Value

The following table shows the possible return values.

Value

Description

ERROR_SUCCESS

Success.

ERROR_SERVICE_NOT_ACTIVE

The Bluetooth stack is not present.

Other standard HRESULT error codes may be returned as appropriate.

Remarks

For more information, see "Inquiry" in the Core Specification v2.1 + EDR on the Bluetooth website.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API Management Functions
Bluetooth AG Service Functions
BthInquiryResult

Other Resources

WSALookupServiceBegin (Windows Sockets)
WSALookupServiceNext (Windows Sockets)
WSALookupServiceEnd (Windows Sockets)