IScheduler::GetNodeList method

Retrieves a list of nodes in the cluster based on the specified filters.


HRESULT GetNodeList(
  [in]  IFilterCollection    *filterProperties,
  [in]  ISortCollection      *sortProperties,
  [out] ISchedulerCollection **pNodes


  • filterProperties [in]
    An IFilterCollection interface that contains one or more filter properties used to filter the list of nodes. If NULL, the method returns all nodes.

  • sortProperties [in]
    An ISortCollection interface that contains one or more sort properties used to sort the list of nodes. If NULL, the list is not sorted.

  • pNodes [out]
    An ISchedulerCollection interface that contains one or more node objects that match the specified filter criteria. Each item in the collection is a variant of type VT_DISPATCH. Query the pdispVal member for the ISchedulerNode interface.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the return value is an error code.


If you specify more than one filter, a logical AND is applied to the filters (for example, return nodes that are reachable and have four sockets).


For an example, see Getting a List of Nodes in the Cluster.



HPC Pack 2008 R2 Client Utilities, HPC Pack 2008 Client Utilities

Type library


See also