Metodo ICLRPolicyManager::SetActionOnFailure

  • Articolo

Specifica l'azione dei criteri che Common Language Runtime (CLR) deve eseguire quando si verifica l'errore specificato.

Sintassi

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

Parametri

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

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

Valore restituito

HRESULT Descrizione
S_OK SetActionOnFailure restituito correttamente.
HOST_E_CLRNOTAVAILABLE CLR non è stato caricato in un processo oppure CLR si trova in uno stato in cui non può eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT Timeout della chiamata.
HOST_E_NOT_OWNER Il chiamante non possiede il blocco.
HOST_E_ABANDONED Un evento è stato annullato durante l'attesa di un thread o di una fibra bloccata.
E_FAIL Si è verificato un errore irreversibile sconosciuto. Dopo che un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG Non è possibile impostare un'azione dei criteri per l'operazione specificata oppure per l'operazione è stata specificata un'azione di criteri non valida.

Commenti

Per impostazione predefinita, CLR genera un'eccezione quando non riesce ad allocare una risorsa, ad esempio la memoria. SetActionOnFailure consente all'host di eseguire l'override di questo comportamento specificando l'azione dei criteri da intraprendere in caso di errore. La tabella seguente illustra le combinazioni di valori EClrFailure (columns) e EPolicyAction (rows) supportati.

FAIL_NonCriticalResource FAIL_CriticalResource FAIL_FatalRuntime FAIL_OrphanedLock FAIL_StackOverflow FAIL_AccessViolation FAIL_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: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche