Previous Topic

Next Topic

ClearSavePoint

Remove the last savepoint without undoing other changes.

Short Name

SAVPCLR()

Type

Low-level function

Declaration

COUNT ClearSavePoint()

Description

ClearSavePoint() removes a savepoint WITHOUT UNDOING the changes made since the savepoint. Calling ClearSavePoint() puts pre-image space in the same state as if the most recently called savepoint had never been called. By comparison, RestoreSavePoint() cancels changes made since the last savepoint, but does NOT remove this savepoint. ClearSavePoint() takes no arguments, and returns an error code if it fails, or zero if successful.

Return

Value

Symbolic Constant

Explanation

0

NO_ERROR

Savepoint cleared.

71

TNON_ERR

No savepoint or no transaction.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.

See also

Abort(), AbortXtd(), Begin(), Commit(), RestoreSavePoint(), SetSavePoint(), TRANRDY()