Compartir a través de

ICLRPolicyManager::SetActionOnFailure (Método)

  • Artículo

Especifica la acción de directiva que Common Language Runtime (CLR) debe realizar cuando se produce el error especificado.

Sintaxis

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

Parámetros

failure
[in] Uno de los valores de EClrFailure, que indica el tipo de error para el que se va a realizar la acción.

action
[in] Uno de los valores de EPolicyAction, que indica la acción que se va a realizar cuando se produce un error. Para obtener una lista de los valores admitidos, vea la sección Comentarios.

Valor devuelto

HRESULT Descripción
S_OK SetActionOnFailure se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Si se devuelve este valor, significa que ocurrió un error grave desconocido. Una vez que un método devuelva el valor E_FAIL, CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG Si se devuelve esta valor, no se puede establecer una acción de directiva para la operación especificada o se ha especificado una acción de directiva no válida para la operación.

Comentarios

De manera predeterminada, CLR produce una excepción cuando no se puede asignar un recurso como la memoria. SetActionOnFailure permite que el host invalide este comportamiento especificando la acción de directiva que se realizará después de que se produzca un error. En la tabla siguiente se muestran las combinaciones de valores de EClrFailure (columnas) y EPolicyAction (filas) que se admiten.

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

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también