pplx 命名空间

pplx 命名空间提供可让你访问 C++ 的并发运行和并发编程框架的类和函数。 有关详细信息,请参阅并发运行时

警告

本主题包含有关 C++ REST SDK 1.0 (codename "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 运行时异步构造。 create_async 的返回类型是基于传递给方法的 lambda 的签名的 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)