AdsCancelUpdate

Advantage Client Engine

Cancels a pending table update.

Syntax

UNSIGNED32

AdsCancelUpdate (ADSHANDLE hTable)

Parameters

hTable (I)

Handle of table or cursor.

Remarks

Calling AdsCancelUpdate will remove any updates to the current record that have not yet been sent to the Advantage server. If the record has been implicitly locked, the implicit lock will be released. If the record was explicitly locked, the lock is still held. If the record was appended in a DBF table, it will be written as a record with fields containing all empty values, the record will be marked for deletion, and the table will remain positioned on the appended record. With ADT tables, canceled appended records are automatically deleted and placed in the record re-use list.

Note BLOB data is written immediately; therefore changes made to fields of type ADS_IMAGE or ADS_BINARY through calls to AdsSetBinary or AdsSetField are not cancelled by calls to AdsCancelUpdate.

Example

Click Here

See Also

AdsLockRecord

AdsSetField

AdsRefreshRecord