ICluster::RequeueTasks method
Queues one or more specified tasks again.
Syntax
HRESULT RequeueTasks(
[in] long jobId,
[in] IClusterEnumerable *taskIds
);
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.taskIds [in]
An IClusterEnumerable interface that contains the identifiers of one or more tasks to queue again. The ITask::get_Id method returns the task identifier value. The variant type of each item in the collection is VT_I4. Set the lVal member of the variant to the identifier.
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
Typically, you call this method if the tasks failed for similar reasons, you fixed the cause of the failure, and you want to try running the tasks again.
If you call this method while tasks are running, the tasks are canceled. You cannot call this method for completed tasks.
If the method fails to queue a task, all subsequent tasks in the job are also not queued. Tasks that were queued before the failure remain queued.
Requirements
Product |
Compute Cluster Pack Client Utilities |
Type library |
Ccpapi.tlb |