FIX: MiniJIT allows Just-In-Time-Activated COM+ components to join their own context (831933)

MORE INFORMATION

Warning If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

This fix adds a new Microsoft COM+ feature that is named MiniJIT. With MiniJIT enabled, a component can take part in JIT activation and can still be activated in the context of its caller. MiniJIT also makes sure that the IObjectControl::Activate method and the IObjectControl::Deactivate methods are appropriately called, and that the transaction and the state of the parent (component of the caller) are not affected when the child component calls any one of the following methods:

• IObjectContext::SetComplete
• IObjectContext::SetAbort
• IObjectContext::EnableCommit
• IObjectContext::DisableCommit

Note With MiniJIT enabled on a component, all the component and application property settings other than those for JIT that are mentioned in the following article still must be set correctly to activate the component in the context of the caller:

Steps to Enable MiniJIT

1. Make sure that the COM+ Hotfix Rollup Package 7 or later is installed.
2. Add the following value to the registry to enable MiniJIT:
   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3
   Key: MiniJITEnabled
   Type: REG_DWORD
   value: 1
3. Set all the component and application property settings that are mentioned in the following article:

   261096 HOWTO: Activate a COM+ Component in Its Caller's Context

4. In the component properties, set the following options to allow the COM+ runtime to determine that the object has MiniJIT enabled:
   • Enable Just In Time Activation
   • Must be activated in callers context

You must correctly identify the candidate components for MiniJIT. Before you apply MiniJIT, you must make sure that these components can be instantiated in the context of the caller. The components must meet the following requirements:

• These components must not use any COM+ services that are other than JIT.
• The component or the components that have MiniJIT enabled must always be called from another component or from other components in the same process. The components that have MiniJIT enabled should not be called from a component or components, or from a client or clients, in another process. Microsoft recommends that you add components that have MiniJIT enabled to a Library package. This makes sure that MiniJIT is created in the process of the callers.
• The component or the components that have MiniJIT enabled must always be called from another component with the same threading model. This make sure that the component or the components can be instantiated on the same Thread or Apartment.

If you do not meet these requirements, the component instantiation may fail with the following error message: 0x80004024: The specified activation could not occur in the client context as specified.

Differences Between JIT and MiniJIT

• The ObjectControl_Activate method for the MiniJIT object is called immediately after you create the object and not when the first method is called. In a typical JIT scenario, ObjectControl_Activate is called when the first method call is made.
• The ObjectControl_Deactivate method for the MiniJIT object is only called when the calling object is destroyed. The Deactivate method of the MiniJIT object is not called immediately after the SetComplete method or the SetAbort method call is made. It is not called even after its last outstanding reference is released. In the typical JIT case, ObjectControl_Deactivate is called after SetComplete or SetAbort or when the last reference is released.