IRegistrationTrigger interface (taskschd.h)

Represents a trigger that starts a task when the task is registered or updated.

Inheritance

The IRegistrationTrigger interface inherits from the ITrigger interface.

Methods

The IRegistrationTrigger interface has these methods.

 
IRegistrationTrigger::get_Delay

Gets or sets the amount of time between when the task is registered and when the task is started. (Get)
IRegistrationTrigger::put_Delay

Gets or sets the amount of time between when the task is registered and when the task is started. (Put)

Remarks

When creating your own XML for a task, a registration trigger is specified using the RegistrationTrigger element of the Task Scheduler schema.

If a task with a delayed registration trigger is registered, and the computer that the task is registered on is shutdown or restarted during the delay, before the task runs, then the task will not run and the delay will be lost.

Examples

For more information and a code example for this interface, see Registration 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

See also

ITrigger

ITriggerCollection

ITriggerCollection::Create

Task Scheduler

Task Scheduler Interfaces