Edit

Share via

IAzScope::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

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

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