PrePrepareEnlistment function

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

Syntax

BOOL PrePrepareEnlistment(
  _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

See also

Kernel Transaction Manager Functions

GetCurrentClockTransactionManager

PrepareEnlistment

ReadOnlyEnlistment

SinglePhaseReject

Send comments about this topic to Microsoft

Build date: 10/26/2012