ICLRPolicyManager::SetActionOnFailure Method

Specifies the policy action the common language runtime (CLR) should take when the specified failure occurs.

HRESULT SetActionOnFailure (
    [in] EClrFailure   failure,
    [in] EPolicyAction action
);

Parameters

  • failure
    [in] One of the EClrFailure values, indicating the type of failure for which to take action.

  • action
    [in] One of the EPolicyAction values, indicating the action to be taken when a failure occurs. The only supported value for a failure value of FAIL_FatalRuntime is eRudeExitProcess. When a fatal error occurs, the CLR is disabled by default. For a failure value of FAIL_CriticalResource or FAIL_NonCriticalResource, the following values are supported:

    • eNoAction

    • eThrowException

    • eAbortThread

    • eRudeAbortThread

    • eUnloadAppDomain

    • eRudeUnloadAppDomain

    • eExitProcess

    • eRudeExitProcess

    • eDisableRuntime

Return Value

HRESULT

Description

S_OK

SetActionOnFailure returned successfully.

HOST_E_CLRNOTAVAILABLE

The CLR has not been loaded into a process, or the CLR is in a state in which it cannot run managed code or process the call successfully.

HOST_E_TIMEOUT

The call timed out.

HOST_E_NOT_OWNER

The caller does not own the lock.

HOST_E_ABANDONED

An event was canceled while a blocked thread or fiber was waiting on it.

E_FAIL

An unknown catastrophic failure occurred. After a method returns E_FAIL, the CLR is no longer usable within the process. Subsequent calls to hosting methods return HOST_E_CLRNOTAVAILABLE.

E_INVALIDARG

A policy action cannot be set for the specified operation, or an invalid policy action was specified for the operation.

Remarks

By default, the CLR throws an exception when it fails to allocate a resource such as memory. SetActionOnFailure allows the host to override this behavior by specifying the policy action to take upon failure.

Requirements

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

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 2.0

See Also

Concepts

EClrFailure Enumeration

EPolicyAction Enumeration

ICLRControl Interface

ICLRPolicyManager Interface