ICLRPolicyManager::SetActionOnFailure 方法

更新:2010 年 7 月

指定在发生指定故障时公共语言运行时 (CLR) 应执行的策略操作。

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

参数

  • failure
    [in] EClrFailure 的值之一,指示对其采取操作的故障类型。

  • action
    [in] EPolicyAction 的值之一,指示要在故障发生时采取的操作。 受支持值的列表请参见“备注”部分。

返回值

HRESULT

说明

S_OK

SetActionOnFailure 已成功返回。

HOST_E_CLRNOTAVAILABLE

CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。

HOST_E_TIMEOUT

调用超时。

HOST_E_NOT_OWNER

调用方不拥有锁。

HOST_E_ABANDONED

事件在被阻止的线程或纤程正在等待它时被取消。

E_FAIL

发生了未知的灾难性故障。 在某方法返回 E_FAIL 后,CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

E_INVALIDARG

无法为指定的操作设置策略操作,或者为该操作指定了无效的策略操作。

备注

默认情况下,CLR 在无法分配内存等资源时引发异常。 SetActionOnFailure 通过指定在发生故障时采取的策略操作来允许宿主重写此行为。 下表显示了受支持的 EClrFailureEPolicyAction 值的组合。 (EClrFailure 值省略了 FAIL_ 前缀。)

NonCriticalResource

关键资源

FatalRuntime

OrphanedLock

StackOverflow

AccessViolation

CodeContract

eNoAction

X

X

不可用

eThrowException

X

X

不可用

eAbortThread

X

X

不可用

X

eRudeAbortThread

X

X

不可用

X

eUnloadAppDomain

X

X

X

不可用

X

eRudeUnloadAppDomain

X

X

X

X

不可用

X

eExitProcess

X

X

X

X

不可用

X

eFastExitProcess

X

X

X

X

不可用

eRudeExitProcess

X

X

X

X

X

不可用

eDisableRuntime

X

X

X

X

X

不可用

要求

**平台:**请参见 .NET Framework 系统要求

**头文件:**MSCorEE.h

**库:**作为一项资源包含在 MSCorEE.dll 中

**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

请参见

参考

EClrFailure 枚举

EPolicyAction 枚举

ICLRControl 接口

ICLRPolicyManager 接口

修订记录

Date

修订记录

原因

2010 年 7 月

更正了允许的 EClrFailureEPolicyAction 值的组合,并将其放到一个表中。

内容 Bug 修复