ITrigger interface (taskschd.h)
Provides the common properties that are inherited by all trigger objects.
Inheritance
The ITrigger interface inherits from the IDispatch interface.
Methods
The ITrigger interface has these methods.
| ITrigger::get_Enabled Gets or sets a Boolean value that indicates whether the trigger is enabled. (Get) |
| ITrigger::get_EndBoundary Gets or sets the date and time when the trigger is deactivated. (Get) |
| ITrigger::get_ExecutionTimeLimit Gets or sets the maximum amount of time that the task launched by this trigger is allowed to run. (Get) |
| ITrigger::get_Id Gets or sets the identifier for the trigger. (Get) |
| ITrigger::get_Repetition Gets or sets a value that indicates how often the task is run and how long the repetition pattern is repeated after the task is started. (Get) |
| ITrigger::get_StartBoundary Gets or sets the date and time when the trigger is activated. (Get) |
| ITrigger::get_Type Gets the type of the trigger. |
| ITrigger::put_Enabled Gets or sets a Boolean value that indicates whether the trigger is enabled. (Put) |
| ITrigger::put_EndBoundary Gets or sets the date and time when the trigger is deactivated. (Put) |
| ITrigger::put_ExecutionTimeLimit Gets or sets the maximum amount of time that the task launched by this trigger is allowed to run. (Put) |
| ITrigger::put_Id Gets or sets the identifier for the trigger. (Put) |
| ITrigger::put_Repetition Gets or sets a value that indicates how often the task is run and how long the repetition pattern is repeated after the task is started. (Put) |
| ITrigger::put_StartBoundary Gets or sets the date and time when the trigger is activated. (Put) |
Remarks
Task Scheduler provides the following individual interfaces for the different triggers that a task can use:
- IBootTrigger
- IDailyTrigger
- IEventTrigger
- IIdleTrigger
- ILogonTrigger
- IMonthlyDOWTrigger
- IMonthlyTrigger
- IRegistrationTrigger
- ITimeTrigger
- IWeeklyTrigger
- ISessionStateChangeTrigger
When reading or writing XML, the triggers of a task are specified in the Triggers element of the Task Scheduler schema.
Examples
For more information and example code for this interface, see Time Trigger Example (C++).
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 |