Methode ICLRPolicyManager::SetActionOnFailure

Artikel
05/10/2023

Hiermee geeft u de beleidsactie op die de Common Language Runtime (CLR) moet uitvoeren wanneer de opgegeven fout optreedt.

Syntaxis

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

Parameters

failure
[in] Een van de EClrFailure-waarden , die het type fout aangeeft waarvoor actie moet worden ondernomen.

action
[in] Een van de EPolicyAction-waarden , die de actie aangeeft die moet worden uitgevoerd wanneer een fout optreedt. Zie de sectie Opmerkingen voor een lijst met ondersteunde waarden.

Retourwaarde

HRESULT	Beschrijving
S_OK	`SetActionOnFailure` is geretourneerd.
HOST_E_CLRNOTAVAILABLE	De CLR is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT	Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER	De beller is niet de eigenaar van het slot.
HOST_E_ABANDONED	Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte.
E_FAIL	Er is een onbekende catastrofale fout opgetreden. Nadat een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	Er kan geen beleidsactie worden ingesteld voor de opgegeven bewerking of er is een ongeldige beleidsactie opgegeven voor de bewerking.

Opmerkingen

Standaard genereert de CLR een uitzondering wanneer het toewijzen van een resource, zoals geheugen, mislukt. SetActionOnFailure hiermee kan de host dit gedrag overschrijven door de beleidsactie op te geven die moet worden uitgevoerd bij een fout. In de volgende tabel ziet u de ondersteunde combinaties van EClrFailure (kolommen) en EPolicyAction (rijen).

	`FAIL_NonCriticalResource`	`FAIL_CriticalResource`	`FAIL_FatalRuntime`	`FAIL_OrphanedLock`	`FAIL_StackOverflow`	`FAIL_AccessViolation`	`FAIL_CodeContract`
`eNoAction`	X	X				N.v.t.
`eThrowException`	X	X				N.v.t.
`eAbortThread`	X	X				N.v.t.	X
`eRudeAbortThread`	X	X				N.v.t.	X
`eUnloadAppDomain`	X	X		X		N.v.t.	X
`eRudeUnloadAppDomain`	X	X		X	X	N.v.t.	X
`eExitProcess`	X	X		X	X	N.v.t.	X
`eFastExitProcess`	X	X		X	X	N.v.t.
`eRudeExitProcess`	X	X	X	X	X	N.v.t.
`eDisableRuntime`	X	X	X	X	X	N.v.t.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Delen via