| Platform SDK: Transaction Server |
[This product will work only on Windows NT 4.0 versions and earlier. For Windows 2000 and later, see COM+ (Component Services).]
Instantiates an MTS object.
Applies To
Syntax
Set object = objectcontext.CreateInstance("progID")
Part
object
An object variable that evaluates to an MTS object.
objectcontext
An object variable that represents the ObjectContext from which to instantiate the new object.
progID
A string expression that is the programmatic ID of the new object's component.
Remarks
CreateInstance creates a COM object. However, the object will have context only if its component is registered with MTS.
When you create an object by using CreateInstance, the new object's context is derived from the current object's ObjectContext and the declarative properties of the new object's component. The new object always executes within the same activity as the object that created it. If the current object has a transaction, the transaction attribute of the new object's component determines whether or not the new object will execute within the scope of that transaction.
If the component's transaction attribute is set to either Requires a transaction or Supports transactions, the new object inherits its creator's transaction. If the component's transaction attribute is set to Requires a new transaction, MTS initiates a new transaction for the new object. If the component's transaction attribute is set to Does not support transactions, the new object doesn't execute under any transaction.
See Also
Creating MTS Objects, Transaction Attributes, MTS Component Requirements