Task Scheduler Interfaces
The interfaces that are described in the following topics provide programmatic access to the functionality that is available within the Task Scheduler.
These topics contain a description of the interface, a list of the properties and methods defined by the interface, and remarks about any special circumstances that should be noted when using the interface.
The following interfaces are introduced in Task Scheduler 2.0, which is used in the Windows Vista operating system.
| Interface | Description |
|---|---|
| IAction | Provides the common properties that are inherited by all action objects. |
| IActionCollection | Contains the actions that are performed by the task. Its methods can be used to add to, remove from, and retrieve the actions of a task. |
| IBootTrigger | Represents a trigger that starts a task when the system is started. |
| IComHandlerAction | Represents an action that fires a handler. |
| IDailyTrigger | Represents a trigger that starts a task based on a daily schedule. |
| IEmailAction | Represents an action that sends an email message. |
| IEventTrigger | Represents a trigger that starts a task when a system event occurs. |
| IExecAction | Represents an action that executes a command-line operation. |
| IIdleSettings | Specifies how the Task Scheduler performs tasks when the computer is in an idle condition. |
| IIdleTrigger | Represents a trigger that starts a task when the computer goes into an idle state. |
| ILogonTrigger | Represents a trigger that starts a task when a user logs on. |
| IMaintenanceSettings | Provides the settings that the Task Scheduler uses to perform task during Automatic maintenance. |
| IMonthlyDOWTrigger | Represents a trigger that starts a task on a monthly day-of-week schedule. |
| IMonthlyTrigger | Represents a trigger that starts a task based on a monthly schedule. |
| INetworkSettings | Provides the settings that the Task Scheduler service uses to obtain a network profile. |
| IPrincipal | Provides the security credentials for a principal. |
| IPrincipal2 | Provides additional security credentials for a principal. |
| IRegisteredTask | Provides the methods that are used to run the task immediately, get any running instances of the task, get or set the credentials that are used to register the task, and the properties that describe the task. |
| IRegisteredTaskCollection | Contains all the tasks that are registered. |
| IRegistrationInfo | Provides the administrative information that can be used to describe the task. This information includes details such as a description of the task, the author of the task, the date the task is registered, and the security descriptor of the task. |
| IRegistrationTrigger | Represents a trigger that starts a task when the task is registered. |
| IRepetitionPattern | Defines how often the task is run and how long the repetition pattern is repeated after the task is started. |
| IRunningTask | Provides the methods to get information from and control a running task. |
| IRunningTaskCollection | Provides a collection that is used to control running tasks. |
| ISessionStateChangeTrigger | Triggers tasks for console connect or disconnect, remote connect or disconnect, or workstation lock or unlock notifications. |
| IShowMessageAction | Represents an action that shows a message box when a task is activated. |
| ITaskDefinition | Defines all the components of a task, such as the task settings, triggers, actions, and registration information. |
| ITaskFolder | Provides the methods that are used to register (create) tasks in the folder, remove tasks from the folder, and create or remove subfolders from the folder. |
| ITaskFolderCollection | Provides information and control for a collection of folders that contain tasks. |
| ITaskHandler | Defines the methods that are called by the Task Scheduler service to manage a COM handler. |
| ITaskHandlerStatus | Provides the methods that are used by COM handlers to notify the Task Scheduler about the status of the handler. |
| ITaskNamedValuePair | Creates a name-value pair in which the name is associated with the value. |
| ITaskNamedValueCollection | Contains a collection of ITaskNamedValuePair interface name-value pairs. |
| ITaskService | Provides access to the Task Scheduler service for managing registered tasks. |
| ITaskSettings | Provides the settings that the Task Scheduler service uses to perform the task. |
| ITaskSettings2 | Provides additional settings that the Task Scheduler uses to perform the task. |
| ITaskVariables | Defines task variables that can be passed as parameters to task handlers and external executables that are launched by tasks. Task handlers that need to input and output data to job variables should do a query interface on the services pointer for ITaskVariables. |
| ITimeTrigger | Represents a trigger that starts a task when the trigger is activated. |
| ITrigger | Provides the common properties that are inherited by all trigger interfaces. |
| ITriggerCollection | Provides the methods that are used to add to, remove from, and get the triggers of a task. |
| IWeeklyTrigger | Represents a trigger that starts a task based on a weekly schedule. |
Warning
The Task Scheduler 1.0 interfaces are available only in Windows 2000, Windows XP, and Windows Server 2003 operating systems. They are deprecated as of Windows Vista and may be removed completely in the future. Please use the Task Scheduler 2.0 interfaces listed above instead.