Bluetooth Framework C++ Edition

◆ HalReadCharacteristicValue()

virtual int HalReadCharacteristicValue ( const wclGattCharacteristic Characteristic,
const wclGattOperationFlag  Flag,
const wclGattProtectionLevel  Protection,
unsigned char *&  Value,
unsigned long &  Length 
)
protectedpure virtual

Implements a hardware-dependent code for reading the value of the specified characteristic.

Parameters
CharacteristicA wclGattCharacteristic structure obtained by previous call to the ReadCaracteristics method.
FlagOperation behavior flag.
ProtectionDescribes the required protection level.
ValueOn output contains a pointer to the characteristic's value. An application is responsible to clean up a memory allocated for the value.
LengthOn output contains a characteristic value length in bytes.
Returns
If the function succeed the return value is WCL_E_SUCCESS. Otherwise the method returns one of the WCL error codes.

A derived class must override this method.

See also
wclGattCharacteristic, wclGattOperationFlag, wclGattProtectionLevel