Share via


BthRevokeLinkKey (Windows Embedded CE 6.0)

1/6/2010

This function removes the link key for a Bluetooth device.

Note

To preserve Win32 compatibility, consider using the Winsock equivalent of this function. To do so, pass SO_BTH_SET_LINK as the optname value in setsockopt.

Syntax

int BthRevokeLinkKey(
  BT_ADDR* pba
);

Parameters

  • pba
    [in] Pointer to the address of the Bluetooth device on which to remove the link key.

Return Value

This function returns ERROR_SUCCESS when it completes successfully.

A return value of ERROR_SERVICE_NOT_ACTIVE indicates that the hardware is not inserted or that the Bluetooth stack is not present.

Other standard error codes may be returned as appropriate.

Remarks

The active connection to the device is not necessary, nor is the presence of the Bluetooth controller.

Link keys are normally managed by Bluetooth stack automatically. They are stored when they are created. Use this function if the pairing partnership with the device is deleted.

Requirements

Header bt_api.h
Library Btdrt.lib
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

Bluetooth OS Functions
BthSetLinkKey

Other Resources

Bluetooth Application Development