35 lines
1.5 KiB
Markdown
35 lines
1.5 KiB
Markdown
# DatabaseTransactionRollback
|
||
|
||
Rolls back transactions.
|
||
|
||
```
|
||
bool DatabaseTransactionRollback(
|
||
int database // database handle received in DatabaseOpen
|
||
);
|
||
|
||
```
|
||
|
||
Parameters
|
||
|
||
database
|
||
|
||
[in] Database handle received in [DatabaseOpen()](/en/docs/database/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.
|
||
|
||
See also
|
||
|
||
[DatabaseExecute](/en/docs/database/databaseexecute),[ DatabasePrepare](/en/docs/database/databaseprepare), [DatabaseTransactionBegin](/en/docs/database/databasetransactionbegin), [DatabaseTransactionCommit](/en/docs/database/databasetransactioncommit)
|