Metodo ICLRPolicyManager::SetActionOnFailure

Specifica l'azione dei criteri che deve essere intrapresa da Common Language Runtime quando si verifica l'errore specificato.

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

Parametri

• failure
  [in] Uno dei valori EClrFailure, che indica il tipo di errore per il quale eseguire l'azione.

• action
  [in] Uno dei valori di EPolicyAction, che indica l'azione da eseguire quando si verifica un errore. Per un elenco dei valori supportati, vedere la sezione Note.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	SetActionOnFailure ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	Non è possibile impostare un'azione dei criteri per l'operazione specificata oppure è stata specificata un'azione dei criteri non valida per l'operazione.

Note

Per impostazione predefinita, Common Language Runtime genera un'eccezione quando non è possibile allocare una risorsa quale la memoria. SetActionOnFailure consente all'host di eseguire l'override di tale comportamento specificando l'azione dei criteri da eseguire in caso di errore. Nella tabella seguente sono illustrate le combinazioni dei valori EClrFailure ed EPolicyAction supportati. (Il prefisso FAIL_prefix viene omesso dai valori di EClrFailure.)

	NonCriticalResource	CriticalResource	FatalRuntime	OrphanedLock	StackOverflow	AccessViolation	CodeContract
eNoAction	X	X				N/D
eThrowException	X	X				N/D
eAbortThread	X	X				N/D	X
eRudeAbortThread	X	X				N/D	X
eUnloadAppDomain	X	X		X		N/D	X
eRudeUnloadAppDomain	X	X		X	X	N/D	X
eExitProcess	X	X		X	X	N/D	X
eFastExitProcess	X	X		X	X	N/D
eRudeExitProcess	X	X	X	X	X	N/D
eDisableRuntime	X	X	X	X	X	N/D

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

Enumerazione EClrFailure

Enumerazione EPolicyAction

Interfaccia ICLRControl

Interfaccia ICLRPolicyManager

Cronologia delle modifiche

Data	Cronologia	Motivo
Luglio 2010	Sono state corrette le combinazioni consentite dei valori EClrFailure e EPolicyAction e sono state inserite in una tabella.	Correzione di bug nel contenuto.