IHostTask::Alert, méthode
Demande que l’hôte réveille la tâche représentée par l’instance IHostTask actuelle, afin que la tâche puisse être abandonnée.
Syntaxe
HRESULT Alert ();
Valeur de retour
HRESULT | Description |
---|---|
S_OK | Retour réussi de la méthode. |
HOST_E_CLRNOTAVAILABLE | Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès. |
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. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE. |
Notes
Le CLR appelle la méthode Alert
quand la méthode Thread.Abort est appelée à partir de code utilisateur, ou lorsque le AppDomain associé au Thread actuel s’arrête. L’hôte doit retourner immédiatement, car l’appel est effectué de façon asynchrone. Si l’hôte ne peut pas alerter la tâche immédiatement, il devra se réveiller la prochaine fois qu’elle entrera dans un état dans lequel elle peut être alertée.
Notes
Alert
affecte uniquement les tâches auxquelles le runtime a passé une valeur WAIT_OPTION de WAIT_ALERTABLE à des méthodes telles que Join.
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