F.17 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 Appendix A "c-tree Plus Error Codes" of the c-tree Plus Programmer's Reference Guide for a complete listing of valid c-tree Plus error values.

SEE ALSO

RestoreSavePoint and SetSavePoint.