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 通过指定在发生故障时采取的策略操作来允许宿主重写此行为。 下表显示了受支持的 EClrFailure 和 EPolicyAction 值的组合。 (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
请参见
参考
修订记录
Date |
修订记录 |
原因 |
---|---|---|
2010 年 7 月 |
更正了允许的 EClrFailure 和 EPolicyAction 值的组合,并将其放到一个表中。 |
内容 Bug 修复 |