Freigeben über


pplx-Namespace

Der pplx-Namespace stellt Klassen und Funktionen bereit, die Ihnen den Zugriff auf die Concurrency Runtime ermöglichen, ein Framework zur parallelen Programmierung für C++. Weitere Informationen finden Sie unter Concurrency Runtime.

Warnung

Dieses Thema enthält Informationen für das C++ REST SDK 1.0 (Codename "Casablanca").Wenn Sie eine neuere Version von der Webseite "Codeplex Casablanca" verwenden, dann verwenden Sie die lokale Dokumentation unter http://casablanca.codeplex.com/documentation.

namespace pplx;

Mitglieder

Typedefs

Name

Beschreibung

task_status

Ein Typ, der den abschließenden Zustand einer Aufgabe darstellt. Gültige Werte sind completed und canceled.

Klassen

Name

Beschreibung

progress_reporter-Klasse (C++-REST-SDK)

Die Status-Reporter-Klasse ermöglicht Benachrichtigungen zum Status der Berichterstellung eines bestimmten Typs. Jedes progress_reporter-Objekt ist an eine bestimmte asynchrone Aktion bzw. einen Vorgang gebunden.

task-Klasse

Die Parallel Patterns Library (PPL) task-Klasse. Ein task-Objekt stellt Arbeit dar, die asynchron und übereinstimmend mit anderen Tasks und paralleler Arbeit , die von parallelen Algorithmen in der Concurrency Runtime erzeugt wird, ausgeführt werden kann. Es enthält bei erfolgreichem Abschluss ein Ergebnis vom Typ _ResultType. Tasks des Typs task<void> führen zu keinem Ergebnis. Ein Task kann erwartet und unabhängig von anderen Tasks abgebrochen werden. Er kann mit anderen Tasks mithilfe von Continuations (then) sowie Join-Muster (when_all) und Choise-Muster (when_any) erstellt werden.

task_completion_event-Klasse (C++-REST-SDK)

Mit der task_completion_event-Klasse können Sie die Ausführung einer Aufgabe verzögern, bis eine Bedingung erfüllt ist, oder eine Aufgabe als Reaktion auf ein externes Ereignis starten.

task_continuation_context-Klasse (C++-REST-SDK)

Mit der task_continuation_context-Klasse können Sie angeben, an welcher Stelle eine Fortsetzung ausgeführt werden soll. Es ist nur sinnvoll, diese Klasse von einer Windows Store-App aus zu verwenden. Bei Apps, die keine Windows Store-Apps sind, wird der Ausführungskontext der Aufgabenfortsetzung von der Laufzeit bestimmt, und kann nicht konfiguriert werden.

task_options-Klasse

Stellt die zulässigen Optionen zum Erstellen einer Aufgabe dar

Funktionen

Name

Beschreibung

cancel_current_task-Funktion (C++-REST-SDK)

Bricht die gerade ausgeführte Aufgabe ab. Diese Funktion kann aus dem Text einer Aufgabe aufgerufen werden, um die Ausführung der Aufgabe abzubrechen und ihn dabei in den canceled Zustand übergehen zu lassen. Obwohl sie als Reaktion auf die is_task_cancellation_requested-Funktion verwendet werden kann, können Sie sie auch alleine zum Initiieren eines Abbruchs der derzeit ausgeführten Aufgabe verwenden.

Der Aufruf dieser Funktion, wenn Sie sich nicht innerhalb des Texts von einem task befinden, ist kein unterstütztes Szenario. Dies würde zu nicht definiertem Verhalten, wie einem Absturz oder einem Hänger in der Anwendung, führen.

create_async-Funktion (C++-REST-SDK)

Erstellt ein asynchrones Konstrukt der Windows Runtime auf einem vom Benutzer angegebenes Lambda oder Funktionsobjekt. Der Rückgabetyp von create_async ist entweder IAsyncAction^, IAsyncActionWithProgress<TProgress>^, IAsyncOperation<TResult>^ oder IAsyncOperationWithProgress<TResult, TProgress>^ auf Grundlage der Signatur des Lambda-Ausdrucks, der an die Methode übergeben wurde.

create_task-Funktion (C++-REST-SDK)

is_task_cancellation_requested-Funktion (C++-REST-SDK)

Gibt zurück, ob die gerade ausgeführte Aufgabe eine Anforderung empfangen hat, die Ausführung abzubrechen. Der Abbruch einer Aufgabe wird angefordert, wenn die Aufgabe mit einem Abbruchtoken erstellt wurde, und die diesem Token zugeordnete Tokenquelle abgebrochen wird.

task_from_exception-Funktion

task_from_result-Funktion

when_all-Funktion (C++-REST-SDK)

Erstellt eine Aufgabe, die erfolgreich abgeschlossen wird, wenn alle als Argumente angegeben Aufgaben erfolgreich abgeschlossen werden.

when_any-Funktion (C++-REST-SDK)

Überladen. Erstellt eine Aufgabe, die erfolgreich abgeschlossen wird, wenn eine der als Argumente angegeben Aufgaben erfolgreich abgeschlossen wird.

Operatoren

Name

Beschreibung

operator&&-Operator (C++-REST-SDK)

Überladen. Erstellt eine Aufgabe, die erfolgreich abgeschlossen wird, wenn beide als Argumente angegeben Aufgaben erfolgreich abgeschlossen werden.

operator||-Operator (C++-REST-SDK)

Anforderungen

Header: pplxtasks.h

Siehe auch

Weitere Ressourcen

Reference (C++-REST-SDK)