ICLRPolicyManager::SetActionOnFailure, méthode

Article
05/10/2023

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

Partager via