Compartilhar via


método de structured_task_group::run

Agenda uma tarefa sobre o structured_task_group objeto.O chamador gerencia o tempo de vida da task_handle objeto passado a _Task_handle parâmetro.A versão que aceita o parâmetro _Placement faz com que a tarefa a ser viesado para executar no local especificado por esse 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
    O tipo de objeto de função que será chamado para executar o corpo do identificador de tarefa.

  • _Task_handle
    Um identificador para o trabalho agendado.Observe que o chamador tem responsabilidade pela vida útil desse objeto.O tempo de execução continuará esperava live até o wait ou run_and_wait método foi chamado na structured_task_group objeto.

  • _Placement
    O local onde a tarefa é representada por uma referência a _Task_handle parâmetro deve ser executado.

Comentários

O runtime cria uma cópia da função de trabalho que você passar para esse método.As alterações de estado que ocorrem em um objeto de função que você passar para esse método não aparecerá em sua cópia desse objeto de função.

Se o structured_task_group destructs como resultado de pilha desenrolar a partir de uma exceção, você não precisa garantir que uma chamada foi feita para ambos os wait ou run_and_wait método.Nesse caso, o destruidor será adequadamente Cancelar e espere a tarefa representada pela _Task_handle parâmetro para concluir.

Lança um invalid_multiple_scheduling exceção se a tarefa de lidar com determinada pelo _Task_handle parâmetro já foi agendado para um objeto de grupo de tarefas via o run método e não houve nenhuma chamada intermediárias a um a wait ou run_and_wait método esse grupo de tarefas.

Requisitos

Cabeçalho: ppl.h

Namespace: concorrência

Consulte também

Referência

classe de structured_task_group

método de structured_task_group::wait

método de structured_task_group::run_and_wait

local de classe

Conceitos

Paralelismo de tarefa (tempo de execução de simultaneidade)