ISchedulerJob::FailOnTaskFailure property

Determines whether the job fails when one of the tasks in the job fails.

This property is read/write.

Syntax

HRESULT put_FailOnTaskFailure(
  [in]  VARIANT_BOOL fail
);

HRESULT get_FailOnTaskFailure(
  [out] VARIANT_BOOL *pFail
);

Property value

Set to VARIANT_TRUE if you want the job to fail when a task fails; otherwise, VARIANT_FALSE.

The Default job template sets the default value to VARIANT_FALSE.

Error codes

If the method succeeds, the return value is S_OK. Otherwise, the return value is an error code. To get a description of the error, access the ISchedulerJob::ErrorMessage property.

Remarks

By default, all tasks in the job will run. However, in some cases, if a task fails, it is no longer necessary to run the entire job.

Requirements

See also

ISchedulerJob