ICluster::AddTask method

Adds the specified task to the specified job.

Syntax

HRESULT AddTask(
  [in]  long  jobId,
  [in]  ITask *Task,
  [out] long  *pRetVal
);

Parameters

• jobId [in]
  The job identifier. The ICluster::AddJob method returns this value. If you have an instance of the job that has already been added to the cluster, you can call the IJob::get_Id method to get the identifier.

• Task [in]
  An ITask interface to the task that you want to add to the job. To create a task, call the ICluster::CreateTask, ICluster::CreateTaskFromXml, or ICluster::CreateTaskFromXmlFile method.

• pRetVal [out]
  The task identifier. The identifier is unique within the job.

Return value

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, call the ICluster::get_ErrorMessage method.

Remarks

The number of tasks that you can add to a job is limited by the size of an integer.

The task cannot be modified after it is added to the job.

Requirements

See also

ICluster

ICluster::AddTasks

ICluster::CancelTask

ICluster::ListTasks

IJob::AddTask