BthFindNextEirRecord (Compact 2013)

3/26/2014

This function gets the next Extended Inquiry Response (EIR) record in the specified enumeration.

Syntax

int BthFindNextEirRecord(
  __in HANDLE hFind,
  __out PBYTE pcbLength,
  __out PBYTE pbDataType,
  __out PBYTE pData,
  __in DWORD cbDataBuffer
);

Parameters

  • pcbLength
    [out] Length of the EIR record in bytes.
  • pbDataType
    [out] Data type of the EIR record.
  • pData
    [out] Record data blob.
  • cbDataBuffer
    [in] Size of the pData buffer in bytes.

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.

ERROR_INVALID_HANDLE

The enumeration handle is not valid.

ERROR_INSUFFICIENT_BUFFER

The pData buffer is too small.

Remarks

To hold the largest possible EIR record, increase the buffer size to 240 bytes.

The enumeration handle must be closed with the BthFindEirRecordClose function.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API Connection Functions
BthFindFirstEirRecord