Partager via

ICLRPolicyManager::SetActionOnFailure, méthode

  • Article

Spécifie l'action de stratégie que le Common Language Runtime (CLR) doit prendre lorsque l'échec spécifié survient.

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

Paramètres

  • failure
    [in] Une des valeurs EClrFailure, indiquant le type d'échec pour lequel effectuer l'action.

  • action
    [in] Une des valeurs EPolicyAction indiquant l'action à prendre lorsqu'un échec se produit. Pour consulter une liste des valeurs prises en charge, reportez-vous à la section Remarques.

Valeur de retour

HRESULT

Description

S_OK

SetActionOnFailure a été retourné avec succès.

HOST_E_CLRNOTAVAILABLE

Le CLR n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.

HOST_E_TIMEOUT

L'appel a expiré.

HOST_E_NOT_OWNER

L'appelant ne possède pas le verrou.

HOST_E_ABANDONED

Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.

E_FAIL

Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

E_INVALIDARG

Impossible de définir une action de stratégie pour l'opération spécifiée ou une action de stratégie non valide a été spécifiée pour l'opération.

Notes

Par défaut, le CLR lève une exception lorsqu'il ne peut pas allouer une ressource telle que la mémoire. SetActionOnFailure permet à l'hôte de modifier ce comportement en spécifiant l'action de stratégie à mettre en œuvre après l'échec. La table suivante montre les combinaisons des valeurs EClrFailure et EPolicyAction qui sont prises en charge. (Le préfixe FAIL_ est omis de valeurs EClrFailure.)

NonCriticalResource

CriticalResource

FatalRuntime

OrphanedLock

StackOverflow

AccessViolation

CodeContract

eNoAction

X

X

N/A

eThrowException

X

X

N/A

eAbortThread

X

X

N/A

X

eRudeAbortThread

X

X

N/A

X

eUnloadAppDomain

X

X

X

N/A

X

eRudeUnloadAppDomain

X

X

X

X

N/A

X

eExitProcess

X

X

X

X

N/A

X

eFastExitProcess

X

X

X

X

N/A

eRudeExitProcess

X

X

X

X

X

N/A

eDisableRuntime

X

X

X

X

X

N/A

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Référence

EClrFailure, énumération

EPolicyAction, énumération

ICLRControl, interface

ICLRPolicyManager, interface

Historique des modifications

Date

Historique

Motif

Juillet 2010

A corrigé les combinaisons autorisées des valeurs EClrFailure et EPolicyAction, puis les a insérées dans un tableau.

Résolution des bogues de contenu.