Share via


IResourceManagerSink

 

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

This is a callback interface implemented by the resource manager. The interface is passed as a parameter to IResourceManagerFactory::Create and registered in the resource manager object. The DTC proxy calls the resource manager's IResourceManagerSink:TMDown callback method if the transaction manager fails. This informs the resource manager that it must perform recovery.

If the connection between the DTC proxy and the transaction manager fails, the DTC proxy first calls the resource manager's ITransactionResourceAsync::PrepareRequest and ITransactionResourceAsync::CommitRequest methods for each transaction enlistment whose outcome is known. The DTC proxy calls the resource manager's ITransactionResourceAsync::TMDown method once for each transaction enlistment whose outcome is not known. In affect, the DTC proxy will run-down all of the resource manager enlistment's. The DTC proxy then calls the resource manager's IResourceManagerSink::TMDown method. This signals the resource manager that all enlistments have been run-down and the resource manager can perform recovery. Note that only the transaction enlistments that received the ITransactionResourceAsync::TMDown method call will need to be recovered.

When to Implement

The resource manager needs to implement this interface.

When to Use

Use this interface to receive notice of a failed transaction manager. The DTC proxy calls on IResourceManagerSink to inform the resource manager that it must perform recovery for the failed transaction manager.

Methods in Vtable Order

IResourceManagerSink method Description
TMDown Called by the DTC proxy to inform the RM that it must perform recovery.

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

IResourceManagerFactory