System.Bluetooth.TBluetoothLEDevice.BeginReliableWrite
Delphi
function BeginReliableWrite: Boolean;
C++
bool __fastcall BeginReliableWrite();
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
function | public | System.Bluetooth.pas System.Bluetooth.hpp |
System.Bluetooth | TBluetoothLEDevice |
Description
Starts a transaction to write a set of characteristics on a 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 value sent 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 that 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).
BeginReliableWrite calls DoBeginReliableWrite.
Platform Support
Platform | Supported |
---|---|
Windows |
|
OS X |
|
iOS |
|
Android |
|