AdsBeginTransaction

Advantage Client Engine

Begins a transaction for all connected servers or for the given server

Syntax

UNSIGNED32

AdsBeginTransaction (ADSHANDLE hConnect);

Parameters

hConnect (I)

Connection handle on which to start transaction. If this is 0, then a transaction will be started on all connected servers that do not have open transactions.

Remarks

Only one transaction can be active per connection; see AdsConnect. If zero is passed as the connection handle, then the Advantage Client Engine begins a transaction on all connections that do not already have active transactions. The error code, AE_TRANS_OUT_OF_SEQUENCE will be returned if a specific connection handle is given to AdsBeginTransaction and that connection is already in a transaction or if zero is given and all connections have active transactions. If zero is given and at least one connection is not in a transaction, then a transaction will be started on that connection and no error will be returned.

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

See Also

AdsCommitTransaction

AdsRollbackTransaction

AdsFailedTransactionRecovery

AdsConnect

AdsInTransaction