Applies to: desktop apps only
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 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
|
Minimum supported client
| Windows Vista, Windows XP with SP2 |
|---|
|
Minimum supported server
| None supported |
|---|
|
Header
|
- BluetoothAPIs.h (include Bthsdpdef.h or BluetoothAPIs.h)
|
|---|
|
Library
|
- Bthprops.lib
|
|---|
See also
-
BluetoothDisplayDeviceProperties
-
BluetoothFindDeviceClose
-
BluetoothFindFirstDevice
-
BluetoothFindNextDevice
-
BluetoothGetDeviceInfo
-
BluetoothRemoveDevice
-
BLUETOOTH_DEVICE_INFO
-
BLUETOOTH_DEVICE_SEARCH_PARAMS
Send comments about this topic to Microsoft
Build date: 2/3/2012