ICLRPolicyManager::SetActionOnFailure – metoda

Článek
05/10/2023

Určuje akci zásad, která by měla modul CLR (Common Language Runtime) provést, když dojde k zadanému selhání.

Syntaxe

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

Parametry

failure
[v] Jedna z hodnot EClrFailure označující typ selhání, pro které se má provést akce.

action
[v] Jedna z hodnot EPolicyAction označující akci, která se má provést při selhání. Seznam podporovaných hodnot najdete v části Poznámky.

Návratová hodnota

HRESULT	Description
S_OK	`SetActionOnFailure` úspěšně vráceno.
HOST_E_CLRNOTAVAILABLE	ClR nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.
HOST_E_TIMEOUT	Časový limit hovoru vypršel.
HOST_E_NOT_OWNER	Volající zámek nevlastní.
HOST_E_ABANDONED	Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno.
E_FAIL	Došlo k neznámému katastrofickému selhání. Jakmile metoda vrátí E_FAIL, clR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	Akci zásad nelze pro zadanou operaci nastavit nebo byla pro operaci zadána neplatná akce zásad.

Poznámky

ClR ve výchozím nastavení vyvolá výjimku, když se mu nepodaří přidělit prostředek, jako je paměť. SetActionOnFailure umožňuje hostiteli přepsat toto chování zadáním akce zásady, která se má provést při selhání. Následující tabulka ukazuje podporované kombinace hodnot EClrFailure (sloupce) a EPolicyAction (řádky).

	`FAIL_NonCriticalResource`	`FAIL_CriticalResource`	`FAIL_FatalRuntime`	`FAIL_OrphanedLock`	`FAIL_StackOverflow`	`FAIL_AccessViolation`	`FAIL_CodeContract`
`eNoAction`	×	×				–
`eThrowException`	×	×				–
`eAbortThread`	×	×				–	×
`eRudeAbortThread`	×	×				–	×
`eUnloadAppDomain`	×	×		×		–	×
`eRudeUnloadAppDomain`	×	×		×	×	–	×
`eExitProcess`	×	×		×	×	–	×
`eFastExitProcess`	×	×		×	×	–
`eRudeExitProcess`	×	×	×	×	×	–
`eDisableRuntime`	×	×	×	×	×	–

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnuto jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Sdílet prostřednictvím