AdsSetRecord

Advantage Client Engine

Sets the current record to the given data buffer.

Syntax

UNSIGNED32

AdsSetRecord (ADSHANDLE hObj,

UNSIGNED8 *pucRec,

UNSIGNED32 ulLen);

Parameters

hObj (I)

Handle of table, cursor, or index order.

pucRec (I)

Return record contents in the buffer.

ulLen (I)

Length of record. This is a validation parameter to tell the Advantage Client Engine the calling application has the correct record length.

Remarks

Using AdsSetRecord is not recommended, especially if there are memo fields or extended data types used in the table. It is very easy to corrupt data with errant calls.

Note The first byte of the record image contains status information on encryption, deletion, and transaction processing that should only be manipulated by Advantage. Therefore, the first byte passed to this function is ignored.

If the handle passed is an index order handle, the logical record buffer of the index order is modified instead of the table data. The logical record buffer of the index order can be used to build a raw index key in conjunction with calls to AdsInitRawKey and AdsBuildRawKey.

Example

Click Here

See Also

AdsGetRecord

AdsSetField

AdsGetRecordLength

AdsInitRawKey

AdsBuildRawKey