DBObjectHandle :: RollBack - Rollback transaction

The function discards all changes made in the transaction. When terminating a transaction for a given transaction level transactions all lower levels are discarded as well. In contrast to other functions RollBack () will not reset the error, i.e. after rolling back the transaction an error set during the transaction is still set.

The function returns an error ( YES ), when the transaction could not be reset because of an error. This may happen when some of the included access blocks could not be reset properly. In this case the error signaled during roll back of transaction will overwrite an error set during the transaction.