ICLRPolicyManager::SetActionOnFailure 메서드
지정된 실패가 발생할 때 CLR(공용 언어 런타임)에서 수행해야 하는 정책 작업을 지정합니다.
구문
HRESULT SetActionOnFailure (
[in] EClrFailure failure,
[in] EPolicyAction action
);
매개 변수
failure
[in] 조치를 취할 실패 유형을 나타내는 EClrFailure 값 중 하나입니다.
action
[in] 실패가 발생할 때 취할 조치를 나타내는 EPolicyAction 값 중 하나입니다. 지원되는 값 목록은 설명 섹션을 참조하세요.
Return Value
HRESULT | 설명 |
---|---|
S_OK | SetActionOnFailure 가 성공적으로 반환되었습니다. |
HOST_E_CLRNOTAVAILABLE | CLR이 프로세스에 로드되지 않았거나 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_NonCriticalResource |
FAIL_CriticalResource |
FAIL_FatalRuntime |
FAIL_OrphanedLock |
FAIL_StackOverflow |
FAIL_AccessViolation |
FAIL_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 | 해당 없음 |
요구 사항
플랫폼:시스템 요구 사항을 참조하세요.
헤더: MSCorEE.h
라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.
.NET Framework 버전: 2.0부터 사용 가능
참고 항목
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
.NET