Freigeben über


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

See also

ICluster

ICluster::RequeueJobs

ICluster::RequeueTask