DatabaseTransactionRollback

Rolls back transactions.

bool  DatabaseTransactionRollback(
   int  database      // database handle received in DatabaseOpen
   );

Parameters

database

[in] Database handle received in DatabaseOpen().

Return true if successful, otherwise false. To get the error code, use GetLastError(), the possible responses are:

ERR_INTERNAL_ERROR (4001) – critical runtime error;
ERR_INVALID_PARAMETER (4003) – sql parameter contains an empty string;
ERR_NOT_ENOUGH_MEMORY (4004) – insufficient memory;
ERR_WRONG_STRING_PARAMETER (5040) – error converting a request into a UTF-8 string;
ERR_DATABASE_INTERNAL (5120) – internal database error;
ERR_DATABASE_INVALID_HANDLE (5121) – invalid database handle;
ERR_DATABASE_EXECUTE (5124) – request execution error.

Note

DatabaseTransactionRollback() call cancels all transactions executed after calling the DatabaseTransactionBegin() function. The DatabaseTransactionRollback() function is necessary for rolling back changes in a database in case errors occur when executing a transaction.