Using isc_rollback_transaction()

Go Up to Ending Transactions

Use isc_rollback_transaction() to restore the database to its condition prior to the start of the transaction. isc_rollback_transaction() also closes the record streams associated with the transaction, resets the transaction name to zero, and frees system resources assigned to the transaction for other uses. ­isc_rollback_transaction() typically appears in error-handling routines. The syntax for isc_rollback_transaction() is:

ISC_STATUS isc_rollback_transaction(
ISC_STATUS *status_vector,
isc_tr_handle *trans_handle);

For example, the following call rolls back a transaction:

isc_rollback_transaction(status_vector, &trans);

where status_vector is a pointer to a previously declared error status vector, and trans is a pointer to a previously declared and initialized transaction handle.

See Isc rollback transaction() for its complete syntax.