Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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