task_continuation_context Class
The task_continuation_context class allows you to specify where you would like a continuation to be executed. It is only useful to use this class from a Windows Store app. For non-Windows Store apps, the task continuation's execution context is determined by the runtime, and not configurable.
Syntax
class task_continuation_context : public details::_ContextCallback;
Members
Public Methods
| Name | Description |
|---|---|
| task_continuation_context::get_current_winrt_context Method | Returns a task continuation context object that represents the current winrt thread context. |
| task_continuation_context::use_arbitrary Method | Creates a task continuation context which allows the Runtime to choose the execution context for a continuation. |
| task_continuation_context::use_current Method | Returns a task continuation context object that represents the current execution context. |
| task_continuation_context::use_default Method | Creates the default task continuation context. |
| task_continuation_context::use_synchronous_execution Method | Returns a task continuation context object that represents the synchronous execution context. |
Inheritance Hierarchy
_ContextCallback
task_continuation_context
Requirements
Header: ppltasks.h
Namespace: concurrency
task_continuation_context::use_arbitrary Method
Creates a task continuation context which allows the Runtime to choose the execution context for a continuation.
static task_continuation_context use_arbitrary();
Return Value
A task continuation context that represents an arbitrary location.
Remarks
When this continuation context is used the continuation will execute in a context the runtime chooses even if the antecedent task is apartment aware.
use_arbitrary can be used to turn off the default behavior for a continuation on an apartment aware task created in an STA.
This method is only available to Windows Store apps.
task_continuation_context::use_current Method
Returns a task continuation context object that represents the current execution context.
static task_continuation_context use_current();
Return Value
The current execution context.
Remarks
This method captures the caller's Windows Runtime context so that continuations can be executed in the right apartment.
The value returned by use_current can be used to indicate to the Runtime that the continuation should execute in the captured context (STA vs MTA) regardless of whether or not the antecedent task is apartment aware. An apartment aware task is a task that unwraps a Windows Runtime IAsyncInfo interface, or a task that is descended from such a task.
This method is only available to Windows Store apps.
task_continuation_context::use_default Method
Creates the default task continuation context.
static task_continuation_context use_default();
Return Value
The default continuation context.
Remarks
The default context is used if you don't specifiy a continuation context when you call the then method. In Windows applications for Windows 7 and below, as well as desktop applications on Windows 8 and higher, the runtime determines where task continuations will execute. However, in a Windows Store app, the default continuation context for a continuation on an apartment aware task is the apartment where then is invoked.
An apartment aware task is a task that unwraps a Windows Runtime IAsyncInfo interface, or a task that is descended from such a task. Therefore, if you schedule a continuation on an apartment aware task in a Windows Runtime STA, the continuation will execute in that STA.
A continuation on a non-apartment aware task will execute in a context the Runtime chooses.