ITaskFolder::CreateFolder method

Creates a folder for related tasks.

Syntax


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

Parameters

folderName [in]

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.

sddl [in]

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

ppFolder [out]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Taskschd.h

Library

Taskschd.lib

DLL

Taskschd.dll

See also

ITaskFolder
Task Scheduler
ITaskFolder

 

 

Show: