__VSTASKCONTINUATIONOPTIONS Enum

Definition

Specifies the task’s continuation options.

public enum class __VSTASKCONTINUATIONOPTIONS
public enum class __VSTASKCONTINUATIONOPTIONS
enum __VSTASKCONTINUATIONOPTIONS
public enum __VSTASKCONTINUATIONOPTIONS
type __VSTASKCONTINUATIONOPTIONS = 
Public Enum __VSTASKCONTINUATIONOPTIONS
Inheritance
__VSTASKCONTINUATIONOPTIONS

Fields

VSTCO_AttachedToParent 4

The task is attached to a parent in the task hierarchy. The parent task is not marked as completed until this child task is completed as well.

VSTCO_Default 131072

The same as VSTCO_NotOnFaulted.

VSTCO_DenyChildAttach 8

An InvalidOperationException is thrown if an attempt is made to attach a child task to the created task.

VSTCO_ExecuteSynchronously 524288

The continuation task should be executed synchronously. With this option specified, the continuation is run on the same thread that causes the antecedent task to transition into its final state. If the antecedent is already complete when the continuation is created, the continuation is run on the thread creating the continuation. Only very short-running continuations should be executed synchronously.

VSTCO_IndependentlyCanceled 1073741824

The task can be canceled independently of any other task.

VSTCO_LazyCancelation 32

In the case of continuation cancellation, prevents completion of the continuation until the antecedent has completed.

VSTCO_LongRunning 2

The task is a long-running, course-grained operation. It provides a hint to the task library that oversubscription may be warranted.

VSTCO_None 0

Default = "Continue on any, no task options, run asynchronously" Specifies that the default behavior should be used. Continuations, by default, are scheduled when the antecedent task completes, regardless of the task's final state.

VSTCO_NotCancelable -2147483648

The continuation task cannot be canceled.

VSTCO_NotOnCanceled 262144

The continuation task should not be scheduled if its antecedent was canceled. This option is not valid for multi-task continuations.

VSTCO_NotOnFaulted 131072

The continuation task should not be scheduled if its antecedent threw an unhandled exception. This option is not valid for multi-task continuations.

VSTCO_NotOnRanToCompletion 65536

The continuation task should not be scheduled if its antecedent ran to completion. This option is not valid for multi-task continuations.

VSTCO_OnlyOnCanceled 196608

The continuation task should be scheduled only if its antecedent was canceled. This option is not valid for multi-task continuations.

VSTCO_OnlyOnFaulted 327680

The continuation task should be scheduled only if its antecedent threw an unhandled exception. This option is not valid for multi-task continuations.

VSTCO_OnlyOnRanToCompletion 393216

The continuation task should be scheduled only if its antecedent ran to completion. This option is not valid for multi-task continuations.

VSTCO_PreferFairness 1

A hint to the task library to schedule a task in as fair a manner as possible, meaning that tasks scheduled sooner are more likely to be run sooner, and tasks scheduled later are more likely to be run later.

Applies to