通过

ITaskFolder：：CreateFolder 方法（taskschd.h）

  • 项目

为相关任务创建文件夹。

语法

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

参数

[in] subFolderName

用于标识文件夹的名称。 如果指定了“FolderName\SubFolder1\SubFolder2”，则如果文件夹不存在，将创建整个文件夹树。 此参数可以是当前 ITaskFolder 实例的相对路径。 根任务文件夹是用反斜杠 （\） 指定的。 根任务文件夹文件夹下的任务文件夹路径示例为 \MyTaskFolder。 “.”字符不能用于指定当前任务文件夹和“.”。 字符不能用于在路径中指定父任务文件夹。

[in] sddl

与文件夹关联的安全描述符，格式为SDDL_REVISION_1格式的VT_BSTR。

[out] ppFolder

表示新子文件夹的 ITaskFolder 接口。

传入对 NULLITaskFolder 接口指针的引用。 引用非NULL 指针可能会导致内存泄漏，因为该指针将被覆盖。

返回值

如果此方法成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码。

言论

若要检索父文件夹的子文件夹，请使用 GetFolders 方法。

如果尝试创建的文件夹已存在，CreateFolder 方法将返回0x800700b7。

在 sddl 参数中指定无效的安全描述符将导致此方法返回 E_INVALIDARG。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 taskschd.h
库 Taskschd.lib
DLL Taskschd.dll

另请参阅

ITaskFolder

任务计划程序