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.