Share via


ISchedulerTask::MaximumNumberOfCores property

Retrieves or sets the maximum number of cores that the scheduler may allocate for the task.

This property is read/write.

Syntax

HRESULT put_MaximumNumberOfCores(
  [in]  long maxCores
);

HRESULT get_MaximumNumberOfCores(
  [out] long *pMaxCores
);

Property value

The maximum number of cores. The default is 1.

Error codes

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, access the ErrorMessage task property.

Remarks

Set this property if the UnitType job property is JobUnitType_Core.

This property tells the scheduler that the task requires at most n cores to run (the scheduler will not allocate more than this number of cores for the task).

The value cannot:

Requirements

Product

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

Type library

Microsoft.Hpc.Scheduler.tlb

See also

ISchedulerTask

ISchedulerTask.MaximumNumberOfNodes

ISchedulerTask.MaximumNumberOfSockets

ISchedulerTask.MinimumNumberOfCores