TASK_INSTANCES_POLICY enumeration (taskschd.h)

  • Article

Defines how the Task Scheduler handles existing instances of the task when it starts a new instance of the task.

Syntax

typedef enum _TASK_INSTANCES_POLICY {
  TASK_INSTANCES_PARALLEL = 0,
  TASK_INSTANCES_QUEUE = 1,
  TASK_INSTANCES_IGNORE_NEW = 2,
  TASK_INSTANCES_STOP_EXISTING = 3
} TASK_INSTANCES_POLICY;

Constants

 
TASK_INSTANCES_PARALLEL
Value: 0
Starts new instance while an existing instance is running.
TASK_INSTANCES_QUEUE
Value: 1
Starts a new instance of the task after all other instances of the task are complete.
TASK_INSTANCES_IGNORE_NEW
Value: 2
Does not start a new instance if an existing instance of the task is running.
TASK_INSTANCES_STOP_EXISTING
Value: 3
Stops an existing instance of the task before it starts a new instance.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header taskschd.h

See also

Task Scheduler Enumerated Types