Bluetooth Framework C++ Edition

◆ ReadCharacteristicValue()

int ReadCharacteristicValue ( const wclGattCharacteristic Characteristic,
const wclGattOperationFlag  Flag,
unsigned char *&  Value,
unsigned long &  Length,
const wclGattProtectionLevel  Protection = plNone 
)

The method reads the value of the specified characteristic.

Parameters
CharacteristicA wclGattCharacteristic structure obtained by previous call to the ReadCaracteristics method.
FlagOperation behavior flag.
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.
ProtectionDescribes the required protection level.
Returns
If the function succeed the return value is WCL_E_SUCCESS. Otherwise the method returns one of the WCL error codes.
See also
wclGattCharacteristic, wclGattOperationFlag, wclGattProtectionLevel