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)