DbRollbackTrans - method of the PmaAdo object

Description:

Cancells transaction over connected database.

Syntax:

Object DbRollbackTrans([String sParams])

Parameters:

sParams	[optional] (String) Additional parameters of the DbRollbackTrans method Entries are in the KeyVal format, for example "return:map;". "return:xxx;" (optional) - Specifies whether the method return value is a map containing multiple values (new procedure) or a single value (old procedure). If not set, then the old procedure is used. map - Returns a map (PmMap object) containing multiple returned values (new procedure) (e.g. Result, AffectedRows, ErrorCode, ErrorText).

sParams

[optional] (String) Additional parameters of the DbRollbackTrans method Entries are in the KeyVal format, for example "return:map;".

"return:xxx;" (optional) - Specifies whether the method return value is a map containing multiple values (new procedure) or a single value (old procedure).
If not set, then the old procedure is used.

map - Returns a map (PmMap object) containing multiple returned values (new procedure) (e.g. Result, AffectedRows, ErrorCode, ErrorText).

Return value:

New procedure: Returns PmMap object with values in following items:

- "Result": empty value (the method does not return anything)

- "ErrorCode": numeric error code where the 0 value means successful method execution (no error)

- "ErrorText": error text description

Old procedure: Returns empty value (the method does not return anything).

Note:

The DbBeginTrans method starts a new transaction over the connected database. All following operations over this database will be confirmed as complete transaction by the DbCommitTrans method or cancelled by the DbRollbackTrans method. Transactions must be supported by both the connected database and the provider.