BthReadLinkPolicySettings (Compact 2013)
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