ITaskDefinition interface (taskschd.h)

Article
02/16/2023

Defines all the components of a task, such as the task settings, triggers, actions, and registration information.

Inheritance

The ITaskDefinition interface inherits from the IDispatch interface.

Methods

The ITaskDefinition interface has these methods.


ITaskDefinition::get_Actions Gets or sets a collection of actions performed by the task. (Get)
ITaskDefinition::get_Data Gets or sets the data that is associated with the task. (Get)
ITaskDefinition::get_Principal Gets or sets the principal for the task that provides the security credentials for the task. (Get)
ITaskDefinition::get_RegistrationInfo Gets or sets the registration information used to describe a task, such as the description of the task, the author of the task, and the date the task is registered. (Get)
ITaskDefinition::get_Settings Gets or sets the settings that define how the Task Scheduler service performs the task. (Get)
ITaskDefinition::get_Triggers Gets or sets a collection of triggers used to start a task. (Get)
ITaskDefinition::get_XmlText Gets or sets the XML-formatted definition of the task. (Get)
ITaskDefinition::put_Actions Gets or sets a collection of actions performed by the task. (Put)
ITaskDefinition::put_Data Gets or sets the data that is associated with the task. (Put)
ITaskDefinition::put_Principal Gets or sets the principal for the task that provides the security credentials for the task. (Put)
ITaskDefinition::put_RegistrationInfo Gets or sets the registration information used to describe a task, such as the description of the task, the author of the task, and the date the task is registered. (Put)
ITaskDefinition::put_Settings Gets or sets the settings that define how the Task Scheduler service performs the task. (Put)
ITaskDefinition::put_Triggers Gets or sets a collection of triggers used to start a task. (Put)
ITaskDefinition::put_XmlText Gets or sets the XML-formatted definition of the task. (Put)

Remarks

When reading or writing your own XML for a task, a task definition is specified using the Task element of the Task Scheduler schema.

Examples

For more information and example code for this interface, see Time Trigger Example (C++), Event Trigger Example (C++), Daily Trigger Example (C++), Registration Trigger Example (C++), Weekly Trigger Example (C++), Logon Trigger Example (C++), or Boot 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