Метод ITaskFolder::CreateFolder (taskschd.h)

Создает папку для связанных задач.

Синтаксис

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

Параметры

[in] subFolderName

Имя, используемое для идентификации папки. Если указан параметр FolderName\SubFolder1\SubFolder2, все дерево папок будет создано, если папки не существуют. Этот параметр может быть относительным путем к текущему экземпляру ITaskFolder. Корневая папка задачи указана с обратной косой чертой (\). Пример пути к папке задач в корневой папке задачи — \MyTaskFolder. Символ '' нельзя использовать для указания текущей папки задачи и ''. Символы нельзя использовать для указания родительской папки задачи в пути.

[in] sddl

Дескриптор безопасности, связанный с папкой, в виде VT_BSTR в формате SDDL_REVISION_1.

[out] ppFolder

Интерфейс ITaskFolder , представляющий новую вложенную папку.

Передайте ссылку на указатель интерфейса NULLITaskFolder. Ссылка на указатель, неNULL может привести к утечке памяти, так как указатель будет перезаписан.

Возвращаемое значение

Если этот метод выполнен успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Замечания

Чтобы получить вложенные папки родительской папки, используйте метод GetFolders.

Метод createFolder возвращает 0x800700b7, если папка, которую вы пытаетесь создать, уже существует.

Указание недопустимого дескриптора безопасности в параметре sddl sddl приведет к возвращению этого метода E_INVALIDARG.

Требования

См. также

ITaskFolder

планировщик задач