ITransactionPhase0EnlistmentAsync::Unenlist
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 Unenlist method to indicate that it is no longer interested in receiving Phase0 notifications. This call cancels an existing enlistment.
The implication of making this call is that the application has no further need to receive phase0 notifications; however, it is still possible that the application will receive a phase0 notification regardless. A phase0 participant who receives a phase0 notification after calling Unenlist may choose to call Phase0Done, but is not required to do so.
The only time at which the participant is guaranteed not to receive a phase0 notification is after its ITransactionPhase0NotifyAsync pointer is released by the phase0 enlistment object.
Syntax
HRESULT Unenlist(void);
Return Values
S_OK
Success.
E_UNEXPECTED
Failure—an unexpected error occurred.
XACT_E_PROTOCOL
Failure—Unenlist was called illegally.
XACT_E_CONNECTION_DOWN
Failure—the connection to the local TM is down.
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