Compartir a través de


structured_task_group::run (Método)

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.

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

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.

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.

Requisitos

Encabezado: ppl.h

Espacio de nombres: Simultaneidad

Vea también

Referencia

structured_task_group (Clase)

structured_task_group::wait (Método)

Conceptos

Paralelismo de tareas (Runtime de simultaneidad)

Otros recursos

structured_task_group::run_and_wait (Método)