IIdleTrigger interface (taskschd.h)

Represents a trigger that starts a task when the computer goes into an idle state. For information about idle conditions, see Task Idle Conditions.

Inheritance

The IIdleTrigger interface inherits from the ITrigger interface.

Remarks

An idle trigger will only trigger a task action if the computer goes into an idle state after the start boundary of the trigger.

When creating your own XML for a task, an idle trigger is specified using the IdleTrigger element of the Task Scheduler schema.

If a task is triggered by an idle trigger, then the WaitTimeout property of the IIdleSettings interface is ignored.

If the initial instance of a task with an idle trigger is still running, then the task is only launched once with no repetitions, even if multiple repetition is defined in the Repetition property. This behavior does not occur if the task stops by itself.

Requirements

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

See also

ITrigger

Task Scheduler Interfaces