Export (0) Print
Expand All

ITimeTrigger interface

Represents a trigger that starts a task at a specific date and time.

Members

The ITimeTrigger interface inherits from ITrigger. ITimeTrigger also has these types of members:

Properties

The ITimeTrigger interface has these properties.

PropertyAccess typeDescription

Enabled

Read/write

Inherited from the ITrigger interface. Gets or sets a Boolean value that indicates whether the trigger is enabled.

EndBoundary

Read/write

Inherited from the ITrigger interface. Gets or sets the date and time when the trigger is deactivated. The trigger cannot start the task after it is deactivated.

ExecutionTimeLimit

Read/write

Inherited from the ITrigger interface. Gets or sets the maximum amount of time that the task launched by this trigger is allowed to run.

Id

Read/write

Inherited from the ITrigger interface. Gets or sets the identifier for the trigger.

RandomDelay

Read/write

Gets or sets a delay time that is randomly added to the start time of the trigger.

Repetition

Read/write

Inherited from the ITrigger interface. Gets or sets how often the task is run and how long the repetition pattern is repeated after the task is started.

StartBoundary

Read/write

Inherited from the ITrigger interface. Gets or sets the date and time when the trigger is activated. This element is required.

Type

Read-only

Inherited from the ITrigger interface. Gets the type of the trigger.

 

Remarks

The StartBoundary element is a required element for time and calendar triggers (TimeTrigger and CalendarTrigger).

When reading or writing XML for a task, an idle trigger is specified using the TimeTrigger element of the Task Scheduler schema.

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]

Header

Taskschd.h

Library

Taskschd.lib

DLL

Taskschd.dll

See also

Task Scheduler Interfaces
Task Scheduler

 

 

Community Additions

ADD
Show:
© 2014 Microsoft