Windows Dev Center

PrepareEnlistment function

Prepares the transaction associated with this enlistment handle. This function is used by communication resource managers (sometimes called superior transaction managers).

Syntax


BOOL PrepareEnlistment(
  _In_ HANDLE         EnlistmentHandle,
  _In_ PLARGE_INTEGER TmVirtualClock
);

Parameters

EnlistmentHandle [in]

A handle to the enlistment for which the prepare operation has completed.

TmVirtualClock [in]

A pointer to the latest virtual clock value received for this transaction.

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_ACCESS_VIOLATION
ERROR_DATATYPE_MISALIGNMENT
ERROR_INVALID_HANDLE
ERROR_INVALID_PARAMETER
ERROR_INSUFFICIENT_RESOURCES
ERROR_OBJECT_NAME_NOT_FOUND
ERROR_OBJECT_TYPE_MISMATCH
ERROR_RM_NOT_JOINED
ERROR_TRANSACTION_NOT_REQUESTED
TRANSACTION_ALREADY_COMMITTED

Requirements

Minimum supported client

Windows Vista with SP1

Minimum supported server

Windows Server 2008

Header

KtmW32.h

Library

KtmW32.lib

DLL

KtmW32.dll

See also

Kernel Transaction Manager Functions
GetCurrentClockTransactionManager
PrePrepareEnlistment
ReadOnlyEnlistment
SinglePhaseReject

 

 

Community Additions

ADD
Show:
© 2015 Microsoft