TwclGattClientConnection.HalReadCharacteristicValue(TwclGattCharacteristic,TwclGattOperationFlag,TwclGattProtectionLevel,TwclGattCharacteristicValue) Method
Implements a hardware-dependent code for reading the value of the specified characteristic.
protected function HalReadCharacteristicValue( const Characteristic: TwclGattCharacteristic; const Flag: TwclGattOperationFlag; const Protection: TwclGattProtectionLevel; out Value: TwclGattCharacteristicValue): Integer; virtual; abstract;
Parameters
- Characteristic
- Type: TwclGattCharacteristic
A TwclGattCharacteristic structure obtained by previous call to the
ReadCaracteristics
method. - Flag
- Type: TwclGattOperationFlag
Operation behavior flag.
- Protection
- Type: TwclGattProtectionLevel
Describes the required protection level.
- Value
- Type: TwclGattCharacteristicValue
On output contains a characteristic's value as bytes array. An application is responsible to clean up a memory allocated for the dynamic array.
Return Value
Type: Integer
If the function succeed the return value is wclErrors.WCL_E_SUCCESS. Otherwise the method returns one of the WCL error codes.
A derived class must override this method.