Partager via

ICLRPolicyManager::SetActionOnFailure, méthode

Spécifie l’action de stratégie que le Common Language Runtime (CLR) doit entreprendre quand l’opération spécifiée expire.

Syntaxe

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

Paramètres

failure
[in] Une des valeurs EClrFailure, indiquant le type d’échec pour lequel une action doit être entreprise.

action
[in] Une des valeurs EPolicyAction, indiquant l’action à entreprendre quand un échec se produit. Pour obtenir la liste des valeurs prises en charge, consultez la section Remarques.

Valeur de retour

HRESULT Description
S_OK SetActionOnFailure retourné.
HOST_E_CLRNOTAVAILABLE Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement.
HOST_E_TIMEOUT L’appel a expiré.
HOST_E_NOT_OWNER L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL Une défaillance catastrophique inconnue s’est produite. Après qu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG Une action de stratégie ne peut pas être définie 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 quand il ne parvient pas à allouer une ressource telle que la mémoire. SetActionOnFailure permet à l’hôte de remplacer ce comportement en spécifiant l’action de stratégie à entreprendre en cas d’échec. Le tableau suivant présente les combinaisons de valeurs EClrFailure (colonnes) et EPolicyAction (lignes) prises en charge.

FAIL_NonCriticalResource FAIL_CriticalResource FAIL_FatalRuntime FAIL_OrphanedLock FAIL_StackOverflow FAIL_AccessViolation FAIL_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

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

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

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi

  • Last updated on