Thread.DisableComObjectEagerCleanup Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Turns off automatic cleanup of runtime callable wrappers (RCW) for the current thread.
public:
void DisableComObjectEagerCleanup();public void DisableComObjectEagerCleanup ();[System.Security.SecurityCritical]
public void DisableComObjectEagerCleanup ();member this.DisableComObjectEagerCleanup : unit -> unit[<System.Security.SecurityCritical>]
member this.DisableComObjectEagerCleanup : unit -> unitPublic Sub DisableComObjectEagerCleanup ()- Attributes
Remarks
By default, the common language runtime (CLR) cleans up runtime callable wrappers automatically. The CLR pumps messages during the cleanup, which might cause reentrancy problems for a few applications that meet the following unusual criteria:
The application does its own message pumping.
The application needs to control precisely when message pumping occurs.
Such applications can use the DisableComObjectEagerCleanup method to prevent the CLR from doing automatic reclamation of runtime callable wrappers.
When this method has been called on a thread, automatic cleanup cannot be re-enabled for that thread. When your application is ready to clean up runtime callable wrappers, use the Marshal.CleanupUnusedObjectsInCurrentContext method to instruct the runtime to clean up all runtime callable wrappers in the current context. Message pumping occurs while the method executes.
