SinglePhaseReject function (ktmw32.h)

Indicates that the resource manager (RM) is refusing a single-phase request. When a transaction manager (TM) receives this call, it initiates a two-phase commit and sends a prepare request to all enlisted RMs.


BOOL SinglePhaseReject(
  [in] HANDLE         EnlistmentHandle,
  [in] PLARGE_INTEGER TmVirtualClock


[in] EnlistmentHandle

A handle to the enlistment.

[in] TmVirtualClock

The latest virtual clock value received from the single-phase request notification. If you specify NULL, the virtual clock value is not changed. See LARGE_INTEGER.

To change the virtual clock value, this value must be greater than the current value returned in the COMMIT notification.

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:


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


Kernel Transaction Manager Functions