Share via


ITransactionPhase0EnlistmentAsync::WaitForEnlistment

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

An application invokes the WaitForEnlistment method if it wishes to block until the phase0 enlistment completes. A return from this method indicates that enlistment has either completed successfully or has failed, as indicated by the status parameter. Note that this is a synchronous call, in contrast to most of the methods in this interface.

Syntax

  
HRESULT WaitForEnlistment(void);  
  

Return Values

S_OK
Success—the asynchronous pull request was queued.

E_OUTOFMEMORY
Failure—out of resources.

E_UNEXPECTED
Failure—an unexpected error occurred.

XACT_E_TMNOTAVAILABLE
Failure—unable to establish a connection with the transaction manager.

XACT_E_CONNECTION_DENIED
Failure—the transaction manager refused to accept a connection.

XACT_E_CONNECTION_DOWN
Failure—connection with the transaction manager was lost.

XACT_E_PROTOCOL
Failure—WaitForEnlistment was called illegally.

XACT_E_NOTRANSACTION
Failure—either there is no transaction, or phase 1 of the transaction has already been started.

Requirements

For an explanation of the requirement values, see Requirements (Component Services).

Platforms: Windows Server 2016, Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista

Header: Declared in txdtc.h

See Also

ITransactionPhase0Factory