Metoda structured_task_group::run_and_wait

Artykuł
02/27/2013

Planuje zadanie do uruchomienia wbudowanej w kontekście wywołującego przy pomocy structured_task_group obiektu dla obsługi pełnego anulowania.Jeśli task_handle obiektu jest przekazywana jako parametr do run_and_wait, obiekt wywołujący jest odpowiedzialna za zarządzanie istnienia task_handle obiektu.Funkcja następnie czeka, aż wszystkie pracować nad structured_task_group obiektu została zakończona lub zostało anulowane.

template<
   class _Function
>
task_group_status run_and_wait(
   task_handle<_Function>& _Task_handle
);

template<
   class _Function
>
task_group_status run_and_wait(
   const _Function& _Func
);

Parametry

_Function
Typ obiektu funkcji, który zostanie wywołany do wykonania zadania.
_Task_handle
Uchwyt do zadania, które będzie uruchamiane wbudowanej w kontekście wywołującego.Należy zauważyć, że obiekt wywołujący ponosi odpowiedzialność za okres istnienia tego obiektu.Środowisko wykonawcze będzie nadal oczekiwać, iż live aż do run_and_wait metoda kończy wykonywanie.
_Func
Funkcja, która będzie wywoływana wywoływanie jednostka pracy.Może to być lambda lub inny obiekt, który obsługuje wersję operator wywołania funkcji z podpisem void operator()().

Wartość zwracana

Wskazanie, czy zostało spełnione oczekiwania lub grupy zadań została anulowana, z powodu jawne Anuluj operację lub jest wyjątek z jednym z jego zadań.Aby uzyskać więcej informacji, zobacz task_group_status

Uwagi

Należy zauważyć, że jeden lub więcej zadań zaplanowanych w tym structured_task_group obiekt wbudowany może być wykonywany w kontekście wywołującego.

Jeśli jeden lub więcej zadań zaplanowanych w tym structured_task_group obiekt zgłasza wyjątek, środowisko wykonawcze będzie zaznacz jeden taki wyjątek jego wybór i propagowanie go z wywołanie run_and_wait metody.

Po powrocie z tej funkcji, structured_task_group obiektu jest uważana w stan końcowy i nie powinny być używane.Należy zauważyć, że wykorzystanie po run_and_wait metoda zwraca spowoduje zachowanie niezdefiniowany.

W wyjątkowych ścieżka wykonanie, masz mandatu wywołanie tej metody albo lub wait metoda przed destruktora z structured_task_group wykonuje.