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 [仅限桌面应用]
目标平台	Windows
标头	taskschd.h
Library	Taskschd.lib
DLL	Taskschd.dll

另请参阅

ITaskFolder

任务计划程序