Edit

IAzApplication::CreateTask method (azroles.h)

  • Article

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

If the method succeeds, the method returns S_OK.

Any other HRESULT 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 IAzApplication object.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header azroles.h
Library Azroles.lib
DLL Azroles.dll
Redistributable Windows Server 2003 Administration Tools Pack on Windows XP