RollbackEnlistment function

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

Syntax


BOOL WINAPI RollbackEnlistment(
  _In_  HANDLE EnlistmentHandle,
  _In_  PLARGE_INTEGER TmVirtualClock
);

Parameters

EnlistmentHandle [in]

A handle to the enlistment.

TmVirtualClock [in]

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:

ERROR_ACCESS_DENIED
ERROR_INVALID_HANDLE
ERROR_INSUFFICIENT_RESOURCES
ERROR_OBJECT_TYPE_MISMATCH
ERROR_PRIVILEGE_NOT_HELD
ERROR_TRANSACTION_EQUEST_NOT_VALID

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

Header

Ktmw32.h

Library

Ktmw32.lib

DLL

Ktmw32.dll

See also

GetCurrentClockTransactionManager
Kernel Transaction Manager Functions
ReadOnlyEnlistment

 

 

Community Additions

ADD
Show:
© 2014 Microsoft