ICLRPolicyManager::SetActionOnFailure (Método)

Artículo
10/07/2008

Actualización: noviembre 2007

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

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 debe realizar la acción.
action
[in] Uno de los valores de EPolicyAction, que indica la acción que se debe realizar cuando se produce un error. El único valor admitido para un valor failure de FAIL_FatalRuntime es eRudeExitProcess. Cuando se produce un error irrecuperable, CLR se deshabilita de forma predeterminada. Para un valor failure de FAIL_CriticalResource o FAIL_NonCriticalResource, se admiten los valores siguientes:
- eNoAction
- eThrowException
- eAbortThread
- eRudeAbortThread
- eUnloadAppDomain
- eRudeUnloadAppDomain
- eExitProcess
- eRudeExitProcess
- eDisableRuntime

Valor devuelto

HRESULT	Descripción
S_OK	SetActionOnFailure se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error irrecuperable desconocido. Cuando un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	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 puede asignar un recurso, como la memoria. SetActionOnFailure permite al host invalidar este comportamiento especificando la acción de directiva que se debe realizar en caso de error.