|
AdsCommitTransaction Advantage Client Engine |
|
|
|
AdsCommitTransaction Advantage Client Engine |
|
|
Commits an active transaction on the given connection
Syntax
UNSIGNED32 |
AdsCommitTransaction (ADSHANDLE hConnect); |
Parameters
hConnect (I) |
Connection handle on which to commit the transaction. If this is 0, then open transactions on all connected servers will be committed. |
Remarks
If zero is passed as the connection handle, then the Advantage Client Engine commits the transaction on all connections that have active transactions. If a connections has nested transactions, the nesting level will be decremented, but the work will not be committed The error code AE_TRANS_OUT_OF_SEQUENCE will be returned if a specific connection handle is given to AdsCommitTransaction and that connection is not in a transaction, or if zero is given and no connections have active transactions. If zero is given and at least one connection is in a transaction, then the transaction(s) will be committed and no error will be returned.
When used in nested transactions, commits of the inner transactions do not commit the data or release locks. Only committing the outer most transaction will commit the work and end the transaction.
Note This API has no effect when used with the Advantage Local Server.
See Also