ICLRPolicyManager::SetActionOnFailure, méthode

Article
08/21/2008

Mise à jour : novembre 2007

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. La seule valeur prise en charge pour une valeur failure de FAIL_FatalRuntime est eRudeExitProcess. Lorsqu'une erreur fatale se produit, le CLR est désactivé par défaut. Pour une valeur failure de FAIL_CriticalResource ou FAIL_NonCriticalResource, les valeurs suivantes sont prises en charge :
- eNoAction
- eThrowException
- eAbortThread
- eRudeAbortThread
- eUnloadAppDomain
- eRudeUnloadAppDomain
- eExitProcess
- eRudeExitProcess
- eDisableRuntime

Valeur de retour

HRESULT	Description
S_OK	SetActionOnFailure a été retourné correctement.
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 échoue lors de l'allocation d'une ressource telle que la mémoire. SetActionOnFailure permet à l'hôte de substituer ce comportement en spécifiant l'action de stratégie à effectuer au moment de l'échec.