Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

BluetoothUpdateDeviceRecord function

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

Syntax


DWORD BluetoothUpdateDeviceRecord(
  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 codeDescription
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.

MemberRequirement
dwSizeMust match the structure size.
AddressMust be a previously found radio address.
szNameMust contain the new name to be stored.

 

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

None supported

Header

BluetoothAPIs.h (include Bthsdpdef.h or BluetoothAPIs.h)

Library

Bthprops.lib

DLL

Bthprops.dll

See also

BluetoothDisplayDeviceProperties
BluetoothFindDeviceClose
BluetoothFindFirstDevice
BluetoothFindNextDevice
BluetoothGetDeviceInfo
BluetoothRemoveDevice
BLUETOOTH_DEVICE_INFO
BLUETOOTH_DEVICE_SEARCH_PARAMS

 

 

Community Additions

Show:
© 2015 Microsoft