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에서는 리소스(예: 메모리)를 할당하지 못할 경우 예외를 throw합니다. SetActionOnFailure를 사용하면 호스트는 오류가 발생할 경우 수행할 정책 작업을 지정하여 이 동작을 재정의할 수 있습니다. 다음 표에서는 지원되는 EClrFailure 및 EPolicyAction 값의 조합을 보여 줍니다. (FAIL_ 접두사는 EClrFailure 값에서 생략됩니다.)
NonCriticalResource |
CriticalResource |
FatalRuntime |
OrphanedLock |
StackOverflow |
AccessViolation |
CodeContract |
|
|---|---|---|---|---|---|---|---|
eNoAction |
X |
X |
N/A |
||||
eThrowException |
X |
X |
N/A |
||||
eAbortThread |
X |
X |
N/A |
X |
|||
eRudeAbortThread |
X |
X |
N/A |
X |
|||
eUnloadAppDomain |
X |
X |
X |
N/A |
X |
||
eRudeUnloadAppDomain |
X |
X |
X |
X |
N/A |
X |
|
eExitProcess |
X |
X |
X |
X |
N/A |
X |
|
eFastExitProcess |
X |
X |
X |
X |
N/A |
||
eRudeExitProcess |
X |
X |
X |
X |
X |
N/A |
|
eDisableRuntime |
X |
X |
X |
X |
X |
N/A |
요구 사항
플랫폼: .NET Framework 시스템 요구 사항 참조
헤더: MSCorEE.h
라이브러리: MSCorEE.dll에 리소스로 포함됨
.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0
참고 항목
참조
변경 기록
날짜 |
변경 내용 |
이유 |
|---|---|---|
|
2010년 7월 |
EClrFailure 및 EPolicyAction 값의 가능한 조합을 수정했으며 이 조합을 테이블에 입력했습니다. |
콘텐츠 버그 수정 |