IHostTask::Alert (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Solicita que el host reactive la tarea representada por la instancia actual de IHostTask para que esta tarea pueda anularse.

HRESULT Alert ();

Valor devuelto

HRESULT	Descripción
S_OK	El método se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

CLR llama al método Alert cuando se invoca a Thread.Abort desde el código de usuario o cuando se cierra el objeto AppDomain asociado con el objeto Thread actual. El host debe devolver un valor inmediatamente, ya que la llamada se ha realizado de forma asincrónica. Si el host no puede alertar a la tarea inmediatamente, se debe reactivar ésta la próxima vez que entre en un estado en el que se la pueda alertar.

Nota

Alert sólo tiene efecto sobre aquellas tareas a las que el motor en tiempo de ejecución ha pasado un valor WAIT_OPTION de WAIT_ALERTABLE para métodos como Join.