ITaskFolder::CreateFolder method (taskschd.h)

Creates a folder for related tasks.

Syntax

HRESULT CreateFolder(
  [in]  BSTR        subFolderName,
  [in]  VARIANT     sddl,
  [out] ITaskFolder **ppFolder
);

Parameters

[in] subFolderName

The name used to identify the folder. If "FolderName\SubFolder1\SubFolder2" is specified, the entire folder tree will be created if the folders do not exist. This parameter can be a relative path to the current ITaskFolder instance. The root task folder is specified with a backslash (\). An example of a task folder path, under the root task folder, is \MyTaskFolder. The '.' character cannot be used to specify the current task folder and the '..' characters cannot be used to specify the parent task folder in the path.

[in] sddl

The security descriptor associated with the folder, in the form of a VT_BSTR in SDDL_REVISION_1 format.

[out] ppFolder

An ITaskFolder interface that represents the new subfolder.

Pass in a reference to a NULL ITaskFolder interface pointer. Referencing a non-NULL pointer can cause a memory leak because the pointer will be overwritten.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

To retrieve the subfolders of the parent folder, use the GetFolders method.

The CreateFolder method will return 0x800700b7 if the folder that you are trying to create already exists.

Specifying an invalid security descriptor in the sddl parameter will cause this method to return E_INVALIDARG.

Requirements

See also

ITaskFolder

Task Scheduler