RegistrationTrigger (triggerGroup) Element
Specifies a trigger that starts a task when the task is registered.
<xs:element name="RegistrationTrigger"
type="registrationTriggerType"
/>
The RegistrationTrigger element is defined by the registrationTriggerType complex type.
Parent element
| Element | Derived from | Description |
|---|---|---|
| Triggers | triggersType | Specifies the triggers that start the task. |
Child elements
| Element | Type | Description |
|---|---|---|
| Delay (registrationTriggerType) | duration | Specifies the amount of time between when the task is registered and when the task is started. |
| Enabled (triggerBaseType) | boolean | Specifies that the trigger is enabled. |
| EndBoundary (triggerBaseType) | dateTime | Specifies the date and time when the trigger is deactivated. The trigger cannot start the task after it is deactivated. |
| ExecutionTimeLimit (triggerBaseType) | duration | Specifies the maximum amount of time in which the task can be started by the trigger. |
| Repetition (triggerBaseType) | repetitionType | Specifies how often the task is run and how long the repetition pattern is repeated after the task is started. |
| StartBoundary (triggerBaseType) | dateTime | Specifies the date and time when the trigger is activated. |
Attributes
| Name | Type | Description |
|---|---|---|
| Id | ID | Identifier of the trigger. |
Remarks
For scripting development, a registration trigger is specified using the RegistrationTrigger object.
For C++ development, a registration trigger is specified using the IRegistrationTrigger interface.
The child elements listed above are defined by the triggerBaseType and registrationTriggerType complex element types. These elements must be added in the sequence shown below.
- StartBoundary (triggerBaseType)
- EndBoundary (triggerBaseType)
- Enabled (triggerBaseType)
- Repetition (triggerBaseType)
- ExecutionTimeLimit (triggerBaseType)
- Delay (registrationTriggerType)
Examples
For a complete example of the XML for a task that specifies a boot trigger, see Registration Trigger Example (XML).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |