共用方式為

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

工作排程器