BthReadRemoteVersion (Compact 2013)

  • Article

3/26/2014

This function reads the version and capabilities of the Link Manager Protocol (LMP) layer on the remote Bluetooth device.

Syntax

int BthReadRemoteVersion(
  BT_ADDR * pba,
  unsigned char *plmp_version,
  unsigned short *plmp_subversion,
  unsigned short *pmanufacturer,
  unsigned char *plmp_features
);

Parameters

For information about the output parameters, see the Core Specification v2.1 + EDR on the Bluetooth website.

Return Value

The following table shows the possible return values.

Value

Description

ERROR_SUCCESS

Success.

ERROR_NOT_FOUND

An active connection to the specified device 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 a combination of the following HCI commands.
  • Read_Remote_Version_Information
  • Read_Remote_Supported_Features

Note

To preserve Microsoft Win32 compatibility, consider using the Winsock equivalent of this function. To do so, set the optname parameter in the getsockopt function to SO_BTH_GET_REMOTE_VER.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API Management Functions
Bluetooth AG Service Functions