RollbackEnlistment function (ktmw32.h)

Rolls back the specified transaction that is associated with an enlistment. This function cannot be called for read-only enlistments.

Syntax

BOOL RollbackEnlistment(
  [in] HANDLE         EnlistmentHandle,
  [in] PLARGE_INTEGER TmVirtualClock
);

[in] EnlistmentHandle

A handle to the enlistment.

[in] TmVirtualClock

The latest virtual clock value received for this enlistment. See LARGE_INTEGER.

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero (0). To get extended error information, call the GetLastError function.

The following list identifies the possible error codes:

This function is used by an RM to roll back a transaction in which it is enlisted. All work associated with the transaction is rolled back.

Rollbacks are allowed by enlistments at any time before it issues a prepare complete notification.