IAzScope::CreateTask method (azroles.h)

The CreateTask method creates an IAzTask object with the specified name.

Syntax

HRESULT CreateTask(
  [in]           BSTR    bstrTaskName,
  [in, optional] VARIANT varReserved,
  [out]          IAzTask **ppTask
);

Parameters

[in] bstrTaskName

Name for the new IAzTask object.

[in, optional] varReserved

Reserved for future use.

[out] ppTask

A pointer to a pointer to the created IAzTask object.

Return value

The return value is an HRESULT. A value of S_OK indicates success. Any other value indicates that the operation failed.

Remarks

You must call the IAzTask::Submit method to persist any changes made to the returned object.

The returned IAzTask object is an immediate child object of the IAzScope object.

Requirements