업데이트: 2007년 11월
지정된 오류가 발생할 경우 CLR(공용 언어 런타임)에서 수행할 정책 작업을 지정합니다.
HRESULT SetActionOnFailure (
[in] EClrFailure failure,
[in] EPolicyAction action
);
매개 변수
failure
[in] 작업을 수행할 대상 오류 형식을 나타내는 EClrFailure 값 중 하나입니다.action
[in] 오류가 발생할 경우 수행할 작업을 나타내는 EPolicyAction 값 중 하나입니다. FAIL_FatalRuntime의 failure 값에는 eRudeExitProcess만 지원됩니다. 오류가 발생하면 기본적으로 CLR이 비활성화됩니다. FAIL_CriticalResource 또는 FAIL_NonCriticalResource의 failure 값에는 다음 값이 지원됩니다.eNoAction
eThrowException
eAbortThread
eRudeAbortThread
eUnloadAppDomain
eRudeUnloadAppDomain
eExitProcess
eRudeExitProcess
eDisableRuntime
반환 값
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를 사용하면 호스트는 오류가 발생할 경우 수행할 정책 작업을 지정하여 이 동작을 재정의할 수 있습니다.
요구 사항
플랫폼:.NET Framework 시스템 요구 사항 참조
헤더: MSCorEE.idl
라이브러리: MSCorEE.dll에 리소스로 포함됨
.NET Framework 버전: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0