ITaskSettings::put_DeleteExpiredTaskAfter method (taskschd.h)

Article
07/27/2022

Gets or sets the amount of time that the Task Scheduler will wait before deleting the task after it expires. If no value is specified for this property, then the Task Scheduler service will not delete the task.

This property is read/write.

Syntax

HRESULT put_DeleteExpiredTaskAfter(
  BSTR expirationDelay
);

Parameters

expirationDelay

Return value

None

Remarks

A task expires after the end boundary has been exceeded for all triggers associated with the task. The end boundary for a trigger is specified by the EndBoundary property inherited by all trigger interfaces.

When reading or writing XML for a task, this setting is specified in the DeleteExpiredTaskAfter (settingsType) element of the Task Scheduler schema.

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
Library	Taskschd.lib
DLL	Taskschd.dll