Advantage Client Engine
Appends an empty record to the end of the given table.
UNSIGNED32 |
AdsAppendRecord (ADSHANDLE hTable); |
hTable (I) |
Handle of table or cursor. |
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.