IDailyTrigger::put_RandomDelay method (taskschd.h)

Gets or sets a delay time that is randomly added to the start time of the trigger.

This property is read/write.

Syntax

HRESULT put_RandomDelay(
  BSTR randomDelay
);

Parameters

randomDelay

Return value

None

Remarks

The specified random delay time is the upper bound for the random interval. The trigger will fire at random during the period specified by the randomDelay parameter, which doesn't begin until the specified start time of the trigger. For example, if the task trigger is set to every seventh day, and the randomDelay parameter is set to P2DT5S (2 day, 5 second time span), then once the seventh day is reached, the trigger will fire once randomly during the next 2 days, 5 seconds.

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

See also

IDailyTrigger