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
程式庫	Taskschd.lib
Dll	Taskschd.dll

另請參閱

ITaskFolder

工作排程器