Dela via

ICLRPolicyManager::SetActionOnFailure, metod

  • Artikel

Anger den principåtgärd som CLR (Common Language Runtime) ska vidta när det angivna felet inträffar.

Syntax

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

Parametrar

failure
[in] Ett av EClrFailure-värdena som anger vilken typ av fel som åtgärden ska utföras för.

action
[in] Ett av EPolicyAction-värdena som anger vilken åtgärd som ska vidtas när ett fel inträffar. En lista över värden som stöds finns i avsnittet Kommentarer.

Returvärde

HRESULT Description
S_OK SetActionOnFailure returnerades.
HOST_E_CLRNOTAVAILABLE CLR har inte lästs in i en process, eller så är CLR i ett tillstånd där den inte kan köra hanterad kod eller bearbeta anropet.
HOST_E_TIMEOUT Tidsgränsen för samtalet överst.
HOST_E_NOT_OWNER Anroparen äger inte låset.
HOST_E_ABANDONED En händelse avbröts medan en blockerad tråd eller fiber väntade på den.
E_FAIL Ett okänt oåterkalleligt fel inträffade. När en metod returnerar E_FAIL kan CLR inte längre användas i processen. Efterföljande anrop till värdmetoder returnerar HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG Det går inte att ange en principåtgärd för den angivna åtgärden eller så har en ogiltig principåtgärd angetts för åtgärden.

Kommentarer

Som standard utlöser CLR ett undantag när det inte går att allokera en resurs, till exempel minne. SetActionOnFailure tillåter att värden åsidosätter det här beteendet genom att ange vilken principåtgärd som ska vidtas vid fel. I följande tabell visas de kombinationer av EClrFailure-värden (kolumner) och EPolicyAction (rader) som stöds.

FAIL_NonCriticalResource FAIL_CriticalResource FAIL_FatalRuntime FAIL_OrphanedLock FAIL_StackOverflow FAIL_AccessViolation FAIL_CodeContract
eNoAction X X Ej tillämpligt
eThrowException X X Ej tillämpligt
eAbortThread X X Ej tillämpligt X
eRudeAbortThread X X Ej tillämpligt X
eUnloadAppDomain X X X Ej tillämpligt X
eRudeUnloadAppDomain X X X X Ej tillämpligt X
eExitProcess X X X X Ej tillämpligt X
eFastExitProcess X X X X Ej tillämpligt
eRudeExitProcess X X X X X Ej tillämpligt
eDisableRuntime X X X X X Ej tillämpligt

Krav

Plattformar: Se Systemkrav.

Huvudet: MSCorEE.h

Bibliotek: Ingår som en resurs i MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 2.0

Se även