Instantiates an MTS object that will execute within the scope of the transaction that was initiated with the creation of the TransactionContext object.
Applies To
Syntax
Set object = transactioncontextobject.CreateInstance(programmaticID)
Part
object
An object variable that evaluates to an MTS object.
transactioncontextobject
An object variable that represents the TransactionContext object from which to create the new object.
programmaticID
The programmatic Id of the new object's component.
Remarks
When a base client uses the TransactionContext object's CreateInstance method to instantiate an MTS object, the new object executes within the transaction context object's activity. If the transaction attribute of the new object's component is set to either Supports transactions or Requires a transaction, the new object also inherits the transaction initiated with the creation of the TransactionContext object. However, if the component that provides the new object has its transaction attribute set to Does not support transactions, the object neither inherits the transaction nor passes it on to objects it subsequently creates. If the component that provides the new object has its transaction attribute set to Requires a new transaction, the MTS run-time environment initiates a new transaction for the new object, and that transaction is the one that's inherited by objects it subsequently creates.
In this respect, using CreateInstance is comparable to using CoCreateInstance and specifying NULL for the controlling IUnknown interface (pUnkOuter).
See Also
Transaction Context Objects, Base Clients, Transactions, CreateInstance