BthReadLinkPolicySettings (Compact 2013)

  • Article

3/26/2014

This function reads the link policy for the existing connection with the specified peer device.

Syntax

int BthReadLinkPolicySettings(
  BT_ADDR *pba,
  unsigned short *plps
);

Parameters

  • pba
    [in] Pointer to the Bluetooth address.

  • plps
    [in] Pointer to the link policy for the existing connection.

    The following table shows the flags that can occur in combination.

    Flag

    Description

    0x0000

    Disables all LAN Manager (LM) modes.

    0x0001

    Enables the master/subordinate device switch.

    0x0002

    Enables hold mode.

    0x0004

    Enables sniff mode.

    0x0008

    Enables park mode.

Return Value

The following table shows the possible return values.

Value

Description

ERROR_SUCCESS

Success.

ERROR_NOT_FOUND

An active connection to the specified peer 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

For more information, see "Read Link Policy Settings" in the Core Specification v2.1 + EDR on the Bluetooth website.

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_LINK_POLIC.

Requirements

Header

bt_api.h

Library

Btdrt.lib

See Also

Reference

Bluetooth API Management Functions
Bluetooth AG Service Functions