AdsCreateSavepoint

Advantage Client Engine

Creates a savepoint in the current transaction.

Syntax

UNSIGNED32 AdsCreateSavepoint (ADSHANDLE hConnect,

UNSIGNED8 *pucSavepoint,

UNSIGNED32 ulOptions );

Parameters

hConnect (I)

Connection handle with an active transaction to create a savepoint on.

pucSavepoint(I)

The name of the savepoint to be created.

ulOptions(I)

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

Remarks

AdsCreateSavepoint creates a savepoint on the active transaction to which the transaction can be rolled back. Rolling back to a savepoint does not end the transaction and only undoes the work performed after the savepoint was created. After rolling back to a savepoint, the savepoint continues to exist and can be rolled back to multiple times. Creating a savepoint with the same name as an existing savepoint destroys the existing savepoint and creates a new savepoint in the transaction at the current location.

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

See Also

AdsCommitTransaction

AdsRollbackTransaction

AdsRollbackTransaction80

AdsFailedTransactionRecovery

AdsConnect

AdsInTransaction