structured_task_group::run (Método)

Artículo
02/19/2013

Programa una tarea en el objeto structured_task_group.El llamador administra la duración del objeto task_handle pasado en el parámetro _Task_handle.La versión que toma el parámetro _Placement hace que la tarea se perjudicado para ejecutarse en la ubicación especificada por ese parámetro.

template<
   class _Function
>
void run(
   task_handle<_Function>& _Task_handle
);

template<
   class _Function
>
void run(
   task_handle<_Function>& _Task_handle,
   location& _Placement
);

Parámetros

_Function
El tipo del objeto de función que se invocará para ejecutar el cuerpo del identificador de tareas.
_Task_handle
Un identificador del trabajo que se está programando.Tenga en cuenta que el llamador tiene la responsabilidad de la duración de este objeto.El runtime o continuará esperando que se encuentre activo hasta que se llame al método wait o run_and_wait en este objeto structured_task_group.
_Placement
Una referencia a la ubicación donde la tarea representada por el parámetro de _Task_handle debe ejecutarse.

Comentarios

El motor en tiempo de ejecución crea una copia de la función de trabajo que se pasa a este método.Los cambios de estado que se produzcan en el objeto de función pasado a este método no aparecerán en su copia de dicho objeto de función.

Si structured_task_group se destruye como resultado del "desenredo" de la pila de una excepción, no necesita garantizar que una llamada se ha realizado al método run_and_wait o wait.En este caso, el destructor se cancelará apropiadamente y esperará a que la tarea representada por el parámetro _Task_handle se complete.

Produce una excepción invalid_multiple_scheduling si el identificador de tareas proporcionado por el parámetro _Task_handle ya se ha programado hacia un objeto de grupo de tareas a través del método run y no hay ninguna llamada que se interponga al método run_and_wait o wait en ese grupo de tareas.