Compartir a través de

ICLRPolicyManager::SetActionOnFailure (Método)

  • Artículo

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. Para obtener una lista de los valores admitidos, vea la sección Comentarios.

Valor devuelto

HRESULT

Descripción

S_OK

SetActionOnFailure finalizó 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 catastrófico 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 forma predeterminada, CLR produce una excepción cuando no puede asignar un recurso, por ejemplo, memoria. SetActionOnFailure permite que el host invalide este comportamiento especificando la acción de directiva que se va a llevar a cabo en caso de error. En la tabla siguiente se muestran las combinaciones admitidas de los valores EClrFailure y EPolicyAction. (El prefijo FAIL_ se omite de los valores 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

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MSCorEE.h

Biblioteca: Se incluye como recurso en MsCorEE.dll

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vea también

Referencia

EClrFailure (Enumeración)

EPolicyAction (Enumeración)

ICLRControl (Interfaz)

ICLRPolicyManager (Interfaz)

Historial de cambios

Fecha

Historial

Motivo

Julio de 2010

Se corrigieron las combinaciones permitidas de los valores EClrFailure y EPolicyAction y se pusieron en una tabla.

Corrección de errores de contenido.