Bluetooth Framework C++ Edition

◆ ReadCharacteristicValue()

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

The method reads 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.
See also
wclGattCharacteristic, wclGattOperationFlag, wclGattProtectionLevel