EClrFailure Enumeration

Describes the set of failures for which a host can set policy actions.

typedef enum {
    FAIL_NonCriticalResource,
    FAIL_CriticalResource,
    FAIL_FatalRuntime,
    FAIL_OrphanedLock
    FAIL_StackOverflow
} EClrFailure;

Members

Member

Description

FAIL_CriticalResource

A failure occurred during an attempt to allocate a resource (such as a thread, a block of memory, or a lock) in a critical region of code.

FAIL_FatalRuntime

The common language runtime (CLR) is no longer able to run managed code in the process. Henceforth, calls to any hosting functions return an HRESULT value of HOST_E_CLRNOTAVAILABLE.

FAIL_NonCriticalResource

A failure occurred during an attempt to allocate a resource (such as a thread, a block of memory, or a lock) in a non-critical region of code.

FAIL_OrphanedLock

A thread has failed to release a lock upon returning from an AppDomain object. The host cannot set this failure to cause a thread to abort. The appropriate setting is EPolicyAction::eUnloadAppDomain.

FAIL_StackOverflow

A stack overflow has occurred. The allowed EPolicyAction Enumeration settings are eDisableRuntime, eExitProcess, eFastExitProcess, eRudeExitProcess, and eRudeUnloadAppDomain.

Remarks

For more information about critical and non-critical regions of code, see EClrOperation.

Requirements

Platforms: See .NET Framework System Requirements.

Header: MSCorEE.idl

Library: MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

See Also

Reference

ICLRPolicyManager Interface

ICLRPolicyManager::SetActionOnFailure Method

IHostPolicyManager Interface

Other Resources

Hosting Enumerations

Change History

Date

History

Reason

June 2010

Added FAIL_StackOverflow.

Customer feedback.