Metodo structured_task_group::run

Articolo
06/09/2015

Consente di pianificare un'attività sull'oggetto structured_task_group. Il chiamante gestisce la durata dell'oggetto task_handle passato nel parametro _Task_handle. La versione che accetta il parametro _Placement fa sì che l'attività possa essere influenzata nell'esecuzione nella posizione specificata da quel parametro.

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

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

Parametri

_Function
Tipo dell'oggetto funzione che sarà richiamato per eseguire il corpo del handle delle attività.
_Task_handle
Un handle al lavoro pianificato. Notare che il chiamante ha la responsabilità della durata del oggetto. Il runtime continuerà a prevedere di esistere finché il metodo wait o run_and_wait non viene chiamato su tale oggetto structured_task_group.
_Placement
Un riferimento alla posizione in cui l'attività rappresentata dal parametro _Task_handle dovrebbe essere eseguita.

Note

Il runtime crea una copia della funzione lavoro passata al metodo . Le modifiche di stato che si verificano in un oggetto funzione passato a questo metodo non saranno visualizzati nella copia dell'oggetto funzione.

Se structured_task_group distrugge come risultato di rimozione dello stack da un'eccezione, non è necessario garantire che una chiamata sia stata effettuata al metodo wait o run_and_wait. In questo caso, il distruttore annullerà in modo appropriato e attenderà l'attività da completare rappresentata dal parametro _Task_handle.

Consente di generare un'eccezione invalid_multiple_scheduling se l'handle delle attività indicate dal parametro _Task_handle è già stato pianificato su un oggetto del gruppo di attività tramite il metodo run e non vi è stata alcuna chiamata al metodo wait o run_and_wait in tale gruppo di attività.