GetBinaryValue method

Builder Syntax	int __fastcall GetBinaryValue(Cardinal uLength);
Delphi Syntax	function GetBinaryValue(uLength: Cardinal): Integer;
Overview	Refer to Working with Data Sets.

Remarks

Updates the BinaryValues property with the binary values associated with the item specified by the CurrentElement property. This method also updates the BinaryValueCount property with uLength, where uLength is the number of bytes of binary data to get.

The retrieved binary data does not undergo any type coercion. It is retrieved in the same form in which it is stored.

If you call this method with uLength greater than the number of bytes of data associated with the specified item, this method will return an error. For example, if there are only three bytes of binary data associated with the specified item and you call this method with uLength set to four, an error will be returned.

This method can be called for every Value Representation, and it will return the exact value in the Value Field (unconverted).