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