ICluster::ListTasksOnNode method

Retrieves a list of all tasks running on the node.

Syntax

HRESULT ListTasksOnNode(
  [in]  BSTR               NodeName,
  [out] IClusterEnumerable **pRetVal
);

Parameters

  • NodeName [in]
    The name of the node.

  • pRetVal [out]
    An IClusterEnumerable interface that contains the collection of tasks. To retrieve the list of ITask interfaces, call the IClusterEnumerable::GetEnumerator method. The variant type of each item is VT_DISPATCH. Query the pdispVal member of the variant for the ITask interface. The enumerable object is empty when there are no tasks to return.

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 list contains tasks associated with jobs, not those associated with commands.

Requirements

Product

Compute Cluster Pack Client Utilities

Type library

Ccpapi.tlb

See also

ICluster

ICluster::ListTasks