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 |
|---|---|
|
The pbtdi parameter is NULL. |
|
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_SEARCH_PARAMS