#include <db_cxx.h> int DbTxn::discard(u_int32_t flags);
The DbTxn::discard() method frees up all the per-process resources
associated with the specified DbTxn handle, neither
committing nor aborting the transaction. This call may be used only
after calls to DbEnv::txn_recover() when
there are multiple global transaction managers recovering transactions
in a single Berkeley DB environment. Any transactions returned by
DbEnv::txn_recover()
that are not handled by the current global transaction manager should
be discarded using DbTxn::discard().
The DbTxn::discard()
method either returns a non-zero error value or throws an
exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
After DbTxn::discard() has been called, regardless of its return,
the DbTxn handle may not
be accessed again.
The DbTxn::discard()
method may fail and throw a DbException
exception, encapsulating one of the following non-zero errors, or return one
of the following non-zero errors: