System.Bluetooth.Components.TBluetoothLE.BeginReliableWrite

Delphi

function BeginReliableWrite(const ADevice: TBluetoothLEDevice): Boolean;

C++

bool __fastcall BeginReliableWrite(System::Bluetooth::TBluetoothLEDevice* const ADevice);

Description

Starts a transaction to write a set of characteristics on the specified remote device as an atomic transaction.

To write a set of characteristics on a remote device as an atomic transaction:

For each characteristic that you want to edit, ensure that the descriptors of the characteristic include a descriptor of kind ExtendedProperties, and that the ReliableWrite property of that descriptor is True, which means that the characteristic supports reliable write operations.
Call BeginReliableWrite to start the transaction.
Call WriteCharacteristic as many times as you want. The remove device does not write the characteristic, it only verifies that the sent value is correct, and queues the change up for an atomic execution. The remote device does trigger however OnCharacteristicWrite; handle this event to verify that the new value the remote device received from you is correct.
After you make all your calls to WriteCharacteristic, do either of the following:
- Call ExecuteReliableWrite to execute the atomic transaction.
- Call AbortReliableWrite to abort the transaction (for example, if you received unexpected data on your handler for OnCharacteristicWrite).