Enlistment Object

 

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

The enlistment object represents the relationship between a resource manager and a transaction object on which the resource manager has enlisted. An enlistment object is created each time a resource manager enlists in a transaction. DTC uses the enlistment object to determine which resource managers to involve in the two-phase commit process.

Origin:	A resource manager creates an enlistment object by calling the IResourceManager::Enlist method. The resource manager typically does this as part of importing a transaction.
Occurrences:	One instance of the enlistment object is present for each call to the IResourceManager::Enlist method. Typically, a resource manager enlists in each transaction only once. However, DTC permits a resource manager to enlist in a transaction as many times as it chooses. Multiple enlistments could occur, for example, if the same transaction is imported to the resource manager from more than one RM proxy.
Duration:	The enlistment object exists for the life of the transactions. It should be released when the transaction completes.
Interfaces:	IUnknown  ITransactionEnlistmentAsync  IPrepareInfo