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 インターフェイス。

ITaskFolder インターフェイス ポインターNULL への参照を渡します。 以外の NULL ポインターを参照すると、ポインターが上書きされるため、メモリ リークが発生する可能性があります。

戻り値

このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。

備考

親フォルダーのサブフォルダーを取得するには、GetFolders メソッドを使用します。

作成しようとしているフォルダーが既に存在する場合、CreateFolder メソッドは0x800700b7を返します。

sddl パラメーターに無効なセキュリティ記述子を指定すると、このメソッドは E_INVALIDARGを返します。

必要条件

関連項目

ITaskFolder の

タスク スケジューラ の