System.Bluetooth.Components.TBluetoothLE.BeginReliableWrite
Delphi
function BeginReliableWrite(const ADevice: TBluetoothLEDevice): Boolean;
C++
bool __fastcall BeginReliableWrite(System::Bluetooth::TBluetoothLEDevice* const ADevice);
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
function | public | System.Bluetooth.Components.pas System.Bluetooth.Components.hpp |
System.Bluetooth.Components | TBluetoothLE |
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).
BeginReliableWrite calls TBluetoothLEDevice.BeginReliableWrite.
Platform Support
Platform | Supported |
---|---|
Windows |
|
OS X |
|
iOS |
|
Android |
|
See Also
- System.Bluetooth.TBluetoothGattDescriptor.ReliableWrite
- System.Bluetooth.Components.TBluetoothLE.WriteCharacteristic
- System.Bluetooth.Components.TBluetoothLE.OnCharacteristicWrite
- System.Bluetooth.Components.TBluetoothLE.ExecuteReliableWrite
- System.Bluetooth.Components.TBluetoothLE.AbortReliableWrite