BluetoothUpdateDeviceRecord function (bluetoothapis.h)

The BluetoothUpdateDeviceRecord function updates the local computer cache about a Bluetooth device.

Syntax

DWORD BluetoothUpdateDeviceRecord(
  const BLUETOOTH_DEVICE_INFO *pbtdi
);

Parameters

pbtdi

A pointer to the BLUETOOTH_DEVICE_INFO structure to update. For more information, see the Remarks section.

Return value

Returns ERROR_SUCCESS upon success. The following table lists common errors.

Return code Description
ERROR_INVALID_PARAMETER
The pbtdi parameter is NULL.
ERROR_REVISION_MISMATCH
The dwSize member of the structure pointed to in the pbtdi parameter is not valid.

Remarks

When updating a Bluetooth device record, the requirements for members of the BLUETOOTH_DEVICE_INFO structure, listed in the following table, must be observed.

Member Requirement
dwSize Must match the structure size.
Address Must be a previously found radio address.
szName Must contain the new name to be stored.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Library Bthprops.lib
DLL bthprops.cpl

See also

BLUETOOTH_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothGetDeviceInfo

BluetoothRemoveDevice