structured_task_group::run-Methode
Plant eine Aufgabe für das structured_task_group-Objekt. Der Aufrufer verwaltet die Lebensdauer des task_handle-Objekts, das im _Task_handle-Parameter übergeben wurde.
template<
class _Function
>
void run(
task_handle<_Function>& _Task_handle
);
Parameter
_Function
Der Typ des Funktionsobjekts, das aufgerufen wird, um den Text des Aufgabenhandles auszuführen._Task_handle
Ein Handle für die Arbeit, die geplant wird. Beachten Sie, dass der Aufrufer die Verantwortung für die Lebensdauer dieses Objekts hat. Die Laufzeit erwartet weiterhin, dass es aktiv ist, bis die wait-Methode oder run_and_wait-Methode für dieses structured_task_group-Objekt aufgerufen wurde.
Hinweise
Beim Testlauf wird eine Kopie der Arbeitsfunktion erstellt, die an diese Methode übergeben wird. Zustandsänderungen, die in einem an diese Methode übergebenen Funktionsobjekt auftreten, werden nicht in der Kopie dieses Funktionsobjekts angezeigt.
Wenn structured_task_group als Ergebnis der Stapelentladung aufgrund einer Ausnahme zerstört wird, müssen Sie nicht garantieren, dass die wait-Methode oder die run_and_wait-Methode aufgerufen wurde. In diesem Fall bricht der Destruktor korrekt ab und wartet auf den Abschluss der durch den _Task_handle-Parameter dargestellten Aufgabe.
Löst eine invalid_multiple_scheduling-Ausnahme aus, wenn das vom _Task_handle-Parameter angegebene Aufgabenhandle bereits für ein Aufgabengruppenobjekt über die run-Methode geplant wurde und es keinen zwischenzeitlichen Aufruf der wait-Methode oder der run_and_wait-Methode für diese Aufgabengruppe gab.
Anforderungen
Header: ppl.h
Namespace: Concurrency
Siehe auch
Referenz
structured_task_group::wait-Methode
Konzepte
Aufgabenparallelität (Concurrency Runtime)