AdsAppendRecord

Advantage Client Engine

Appends an empty record to the end of the given table.

Syntax

UNSIGNED32

AdsAppendRecord (ADSHANDLE hTable);

Parameters

hTable (I)

Handle of table or cursor.

Remarks

AdsAppendRecord appends a blank record to the end of the table, locks the record, and positions the table to the new record. Changes are written when the user moves off of the appended record or calls AdsWriteRecord. Transactions have some affect on appending records; see Advantage Transaction Processing for more information on appends during transactions.

Note With ADT tables, Advantage implements a record re-use algorithm that recycles records that have been deleted (AdsDeleteRecord). This means that the newly appended record may not actually be at the end of the table. An application should not make any assumptions about the new record number.

Example

Click Here

See Also

AdsDeleteRecord

AdsGetRecordNum