Transaction Options 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 transaction options object contains transaction attribute information such as the time-out for the transaction and the name of the transactions. The transaction options object is passed as a parameter to the ITransactionDispenser::BeginTransaction method when creating a new transaction. The transaction attributes contained in the transaction options object are inherited by the newly created transaction object. A transaction options object can be used across multiple transactions.

Origin:	An application program or resource manager creates a transaction options object by calling the ITransactionDispenser::GetOptionsObject method. This is typically done during program initialization.
Occurrences:	One instance of the transaction options object is present for each call to the ITransactionDispenser::GetOptionsObject method. Typically an application program or resource manager will create one or two transaction options objects. However, a program may create as many transaction options objects as it chooses.
Duration:	The transaction options object normally exists for the life of the program. It should be released at the completion of the program.
Interfaces:	IUnknown  ITransactionOptions