The work items performed by a task are called actions. A task can have a single action or a maximum of 32 actions. Be aware that when multiple actions are specified, they are executed sequentially.
Types of Actions
The following table of actions describes the type of work or actions that can be accomplished by a task.
|Type of Action||Description|
|ComHandler Action||This action fires a COM handler.|
|Exec Action||This action executes a command-line operation such as starting Notepad.|
|E-mail Action||This action sends an email when a task is triggered.|
|Show Message Action||This action shows a message box with a specified message and title.|
The actions of a task are specified when the task is defined and stored in a collection of actions used by the Task Scheduler service. The following table lists links to reference topics for the APIs and XML elements that are associated with actions.
For more information and examples about how to use the Task Scheduler interfaces, scripting objects, and XML, see Using the Task Scheduler.
Interface APIs for C++ Development
|Actions Property of ITaskDefinition||Gets or sets the actions performed by the task.|
|IActionCollection||Contains the actions performed by the task.|
|IComHandlerAction||Represents an action that fires a handler.|
|IExecAction||Represents an action that executes a command-line operation.|
|IEmailAction||Represents an action that sends an email message.|
|IShowMessageAction||Represents an action that shows a message box.|
Scripting Object APIs for Scripting Development
|TaskDefinition.Actions||Gets or sets the actions performed by the task.|
|ActionCollection||Contains the actions performed by the task.|
|ComHandlerAction||Represents an action that fires a handler.|
|ExecAction||Represents an action that executes a command-line operation.|
|EmailAction||Represents an action that sends an email message.|
|ShowMessageAction||Represents an action that shows a message box.|
|Actions||Defines the actions performed by the task.|
|ComHandler||Represents an action that fires a handler.|
|Exec||Represents an action that executes a command-line operation.|
|SendEmail||Represents an action that sends an email message.|
|ShowMessage||Represents an action that shows a message box.|
Using Variables in Action Properties
Some action properties that are of type BSTR can contain $(Arg0), $(Arg1), ..., $(Arg32) variables in their string values. These variables are replaced with the values that are specified in the params parameter of the IRegisteredTask::Run and IRegisteredTask::RunEx methods or are contained within the event trigger for the task. The following table lists the action properties that can use variables in their string values.
|COM Handler Action||C++:
|Show Message Action||C++: