Metodo structured_task_group::run

Articolo
03/05/2013

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 causa l'attività essere influenzato da eseguire nel percorso specificato dal 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 al percorso in cui l'attività rappresentata dal parametro di _Task_handle necessario eseguire.

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à.