AdsRollbackTransaction80

Advantage Client Engine

Rolls back the active transaction on the given connection entirely or to an existing savepoint.

Syntax

UNSIGNED32 AdsRollbackTransaction (ADSHANDLE hConnect,

UNSIGNED8 *pucSavepoint,

UNSIGNED32 ulOptions );

Parameters

hConnect (I)

Connection handle on which to roll back the transaction.

pucSavepoint(I)

The name of the savepoint to roll back to. This value should be NULL to rollback an entire transaction.

ulOptions(I)

Options for the command. At this time there are no options.

Remarks

This command rolls back an active transaction to an existing savepoint or rolls back the transaction entirely. When rolling back a transaction to a savepoint, all savepoints created after the savepoint are removed while the savepoint itself remains. The error code, AE_TRANS_OUT_OF_SEQUENCE, will be returned if the connection handle given is not in a transaction.

Note This API has no effect when used with the Advantage Local Server.

See Also

AdsBeginTransaction

AdsCommitTransaction

AdsRollbackTransaction

AdsCreateSavepoint

AdsInTransaction

AdsFailedTransactionRecovery

AdsConnect

AdsConnect60