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
);

Parameters

[in] EnlistmentHandle

A handle to the enlistment.

[in] TmVirtualClock

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

Return value

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:

Remarks

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.

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header ktmw32.h
Library Ktmw32.lib
DLL Ktmw32.dll

See also

GetCurrentClockTransactionManager

Kernel Transaction Manager Functions

ReadOnlyEnlistment