pplx 命名空間

pplx 命名空間提供可讓您存取並行執行階段 (C++ 的並行程式設計架構) 的類別和函式。 如需詳細資訊,請參閱並行執行階段

警告

此主題包含 C++ REST SDK 1.0 (代號名稱 "Casablanca") 的相關資訊。如果您是使用 Codeplex Casablanca 網頁 提供的較新版本,則請使用位於 http://casablanca.codeplex.com/documentation 的本機說明文件。

namespace pplx;

Members

Typedef

名稱

描述

task_status

代表工作終止狀態的類型。 有效值為 completedcanceled

類別

名稱

描述

progress_reporter 類別 (C++ REST SDK)

進度報告程式類別可供報告特定類型的進度通知。 每個 progress_reporter 物件都繫結至特定的非同步動作或作業。

task 類別

平行模式程式庫 (PPL) task 類別。 task 物件代表可以非同步執行,並可與其他工作以及並行執行階段中平行演算法所產生的平行工作同時執行的工作。 成功完成時,會產生 _ResultType 類型的結果。 task<void> 類型的工作不會產生任何結果。 工作可以獨立於其他工作,個別等候及取消。 您也可以使用 continuations(then)、join(when_all) 和 choice(when_any) 等模式,將工作與其他工作組合在一起。

task_completion_event 類別 (C++ REST SDK)

task_completion_event 類別可讓您延遲執行工作,直到滿足某條件,或是為了回應外部事件而開始工作。

task_continuation_context 類別 (C++ REST SDK)

task_continuation_context 類別可讓您指定您想要執行接續的位置。 必須從 Windows 市集應用程式使用此類別才有效。 針對非 Windows 市集應用程式,工作接續的執行內容是由執行階段決定,而且無法設定。

task_options 類別

代表可用來建立工作的選項。

函式

名稱

描述

cancel_current_task 函式 (C++ REST SDK)

取消目前執行的工作。 這個函式可以從工作主體內呼叫,以中止工作執行並導致它進入 canceled 狀態。 雖然它可用於回應 is_task_cancellation_requested 函式,但也可以個別用來初始化目前執行工作的取消作業。

如果不是在 task 的主體中,這就不是支援呼叫這個函式的情況。 這樣做會在應用程式中導致未定義的行為,例如當機或停止回應。

create_async 函式 (C++ REST SDK)

以使用者提供的 Lambda 或函式物件為基礎,建立 Windows 執行階段非同步建構。 根據傳遞至方法的 Lambda 簽章,create_async 的傳回類型是下列其中一個:IAsyncAction^IAsyncActionWithProgress<TProgress>^IAsyncOperation<TResult>^IAsyncOperationWithProgress<TResult, TProgress>^

create_task 函式 (C++ REST SDK)

is_task_cancellation_requested 函式 (C++ REST SDK)

傳回指示,指出目前執行的工作是否已收到取消其執行的要求。 如果工作是以語彙基元來建立,而與該語彙基元相關聯的語彙基元來源被取消,則會要求取消工作。

task_from_exception 函式

task_from_result 函式

when_all 函式 (C++ REST SDK)

建立工作,這個工作將會在當做引數提供的所有工作都已順利完成時成功完成。

when_any 函式 (C++ REST SDK)

多載。 建立工作,當成引數來提供的任何工作順利完成時,此工作就會順利成功。

運算子

名稱

描述

operator&& 運算子 (C++ REST SDK)

多載。 建立工作,這個工作將會在兩個當做引數提供的工作都已順利完成時成功完成。

operator|| 運算子 (C++ REST SDK)

需求

**標頭:**pplxtasks.h

請參閱

其他資源

參考 (C++ REST SDK)