ITask::put_CommandLine method

Sets the command line for the task.

Syntax

HRESULT put_CommandLine(
  [in] BSTR Val
);

Parameters

  • Val [in]
    The command line. The command is limited to 480 Unicode characters.

Return value

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

Remarks

The command line is required for all tasks. The command line must include the name of the executable program and any arguments. If the path to the executable program contains long file names, enclose the path in quotation marks.

For more information about specifying the command line, see the description for the command line parameter of the Win32 CreateProcess function.

The executable program must exist under the specified path on each node specified in the ITask::put_RequiredNodes method. If you do not specify a list of required nodes, the executable program must exist on each node in the cluster. The same is true if you add the task to a job and the job does not use the IJob::put_AskedNodes method to limit the nodes on which the task runs.

Requirements

Product

Compute Cluster Pack Client Utilities

Type library

Ccpapi.tlb

See also

ITask

ITask::get_CommandLine