SinglePhaseReject function

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.

Syntax


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

Parameters

EnlistmentHandle [in]

A handle to the enlistment.

TmVirtualClock [in]

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:

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

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

 

 

Community Additions

ADD
Show:
© 2015 Microsoft