EPolicyAction Enumeration

Describes the policy actions the host can set for operations described by EClrOperation Enumeration and failures described by EClrFailure Enumeration.

typedef enum {
    eNoAction,
    eThrowException,
    eAbortThread,
    eRudeAbortThread,
    eUnloadAppDomain,
    eRudeUnloadAppDomain,
    eExitProcess,
    eFastExitProcess,
    eRudeExitProcess,
    eDisableRuntime
} EPolicyAction;

Members

Member	Description
eAbortThread	Specifies that the common language runtime (CLR) should abort the thread gracefully. A graceful abort includes attempts to run all finally blocks, any catch blocks related to thread aborts, and finalizers.
eDisableRuntime	Specifies that the CLR should enter a disabled state. No further managed code can be executed in the affected process, and threads are blocked from entering the CLR.
eExitProcess	Specifies that the CLR should attempt a graceful exit of the process, including running finalizers and performing cleanup and logging operations.
eFastExitProcess	Specifies that the CLR should exit the process immediately, without running finalizers or performing cleanup and logging operations. Nowever, notification is sent to the debugger.
eNoAction	Specifies that no action should be taken.
eRudeAbortThread	Specifies that the CLR should perform a rude thread abort. Only those catch and finally blocks marked with MustRunInClientContextAttribute are executed.
eRudeExitProcess	Specifies that the CLR should exit the process without running finalizers or logging operations.
eRudeUnloadAppDomain	Specifies that the CLR should perform a rude unload of the AppDomain. Only finalizers marked with MustRunInClientContextAttribute are executed. Similarly, all threads with this AppDomain in their stack receive a ThreadAbortException, but only those catch and finally blocks marked with MustRunInClientContextAttribute are executed.
eThrowException	Specifies that an exception appropriate to the condition, such as out-of-memory, buffer overflow, and so forth, should be thrown.
eUnloadAppDomain	Specifies that the AppDomain should be unloaded. The CLR attempts to run finalizers.

Remarks

The host sets policy actions by calling methods of the ICLRPolicyManager Interface interface. For information about rude and graceful aborts, see the EClrOperation Enumeration enumeration.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: MSCorEE.idl

Library: MSCorEE.dll

.NET Framework Version: 2.0

See Also

Reference

EClrFailure Enumeration
ICLRPolicyManager Interface
IHostPolicyManager Interface

Other Resources

Hosting Enumerations