title | description | ms.assetid | keywords | topic_type | api_name | api_type | ms.topic | ms.date | api_location | ||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
MultipleInstancesPolicy (settingsType) Element |
Specifies the policy that defines how the Task Scheduler deals with multiple instances of the task. |
ec82d396-f83c-4684-98ab-f70e15ada075 |
|
|
|
|
reference |
05/31/2018 |
Specifies the policy that defines how the Task Scheduler deals with multiple instances of the task.
<xs:element name="MultipleInstancesPolicy"
type="multipleInstancesPolicyType"
/>
The MultipleInstancesPolicy element is defined by the multipleInstancesPolicyType simple type.
Element | Derived from | Description |
---|---|---|
Settings | settingsType | Contains the settings that the Task Scheduler uses to perform the task. |
For C++ development, see MultipleInstances Property of ITaskSettings.
For script development, see TaskSettings.MultipleInstances.
This element is restricted to the following values.
- Parallel: Starts a new instance while an existing instance is running.
- Queue: Starts a new instance of task after all other instances of the task are complete.
- IgnoreNew: Default. Does not start a new instance if an existing instance of the task is running.
- StopExisting: Stops an existing instance of the task before it starts a new instance.
The following XML defines a settings element that allows multiple instances of the task to run in parallel.
<Settings>
<MultipleInstancesPolicy>Parallel</MultipleInstancesPolicy>
</Settings>
Requirement | Value |
---|---|
Minimum supported client |
Windows Vista [desktop apps only] |
Minimum supported server |
Windows Server 2008 [desktop apps only] |