ICLRPolicyManager::SetActionOnTimeout, méthode

Article
08/10/2011

Spécifie l'action de stratégie que le Common Language Runtime (CLR) doit prendre lorsque l'opération spécifiée arrive à expiration.

HRESULT SetActionOnTimeout (
    [in] EClrOperation operation,
    [in] EPolicyAction action
);

Paramètres

operation
[in] Une des valeurs EClrOperation, indiquant l'opération pour laquelle spécifier l'action de délai d'attente. Les valeurs suivantes sont prises en charge :
- OPR_AppDomainUnload
- OPR_ProcessExit
- OPR_ThreadRudeAbortInCriticalRegion
- OPR_ThreadRudeAbortInNonCriticalRegion
action
[in] Une des valeurs EPolicyAction, indiquant l'action de stratégie à prendre lorsque l'opération arrive à expiration.

Valeur de retour

HRESULT	Description
S_OK	SetActionOnTimeout 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	Il est impossible de définir un délai d'attente pour l'operation spécifiée, ou une valeur non valide a été fournie pour l'operation.

Notes

La valeur du délai d'attente peut être soit le délai par défaut défini par le Common Language Runtime (CLR) soit une valeur spécifiée par l'hôte dans un appel à la méthode ICLRPolicyManager::SetTimeout.

Les valeurs d'actions de stratégie ne peuvent pas toutes être spécifiées en tant que comportement de délai d'attente pour les opérations du Common Language Runtime (CLR). SetActionOnTimeout est généralement utilisé uniquement pour transmettre le comportement. Par exemple, un hôte peut spécifier que les abandons de thread doivent être transformés en abandons de thread non applicables, mais il ne peut pas spécifier le contraire. Le tableau suivant décrit les valeurs action valides pour les valeurs operation valides.

Valeur d'operation	Valeurs valides d'action
OPR_ThreadRudeAbortInNonCriticalRegion OPR_ThreadRudeAbortInCriticalRegion	eRudeAbortThread eUnloadAppDomain eRudeUnloadAppDomain eExitProcess eFastExitProcess eRudeExitProcess eDisableRuntime
OPR_AppDomainUnload	eUnloadAppDomain eRudeUnloadAppDomain eExitProcess eFastExitProcess eRudeExitProcess eDisableRuntime
OPR_ProcessExit	eExitProcess eFastExitProcess eRudeExitProcess eDisableRuntime

OPR_ThreadRudeAbortInNonCriticalRegion

OPR_ThreadRudeAbortInCriticalRegion