IIdleSettings interface

Specifies how the Task Scheduler performs tasks when the computer is in an idle condition. For information about idle conditions, see Task Idle Conditions.

Methods

The IIdleSettings interface has these methods.

Method Description
IIdleSettings::get_IdleDuration Gets or sets a value that indicates the amount of time that the computer must be in an idle state before the task is run.
IIdleSettings::get_RestartOnIdle Gets or sets a Boolean value that indicates whether the task is restarted when the computer cycles into an idle condition more than once.
IIdleSettings::get_StopOnIdleEnd Gets or sets a Boolean value that indicates that the Task Scheduler will terminate the task if the idle condition ends before the task is completed. The idle condition ends when the computer is no longer idle.
IIdleSettings::get_WaitTimeout Gets or sets a value that indicates the amount of time that the Task Scheduler will wait for an idle condition to occur.
IIdleSettings::put_IdleDuration Gets or sets a value that indicates the amount of time that the computer must be in an idle state before the task is run.
IIdleSettings::put_RestartOnIdle Gets or sets a Boolean value that indicates whether the task is restarted when the computer cycles into an idle condition more than once.
IIdleSettings::put_StopOnIdleEnd Gets or sets a Boolean value that indicates that the Task Scheduler will terminate the task if the idle condition ends before the task is completed. The idle condition ends when the computer is no longer idle.
IIdleSettings::put_WaitTimeout Gets or sets a value that indicates the amount of time that the Task Scheduler will wait for an idle condition to occur.

Remarks

When reading or writing XML for a task, this setting is specified in the IdleSettings 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.

Examples

For more information and example code for this interface, see Time Trigger Example (C++).

Requirements

   
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

ITaskSettings

Task Scheduler

Task Scheduler Interfaces