IActionCollection::Create メソッド (taskschd.h)

新しいアクションを作成し、コレクションに追加します。

構文

HRESULT Create(
  [in]  TASK_ACTION_TYPE type,
  [out] IAction          **ppAction
);

パラメーター

[in] type

このパラメーターは、次のいずれかの TASK_ACTION_TYPE 列挙定数に設定されます。

価値 意味
TASK_ACTION_EXEC
0
このアクションは、コマンド ライン操作を実行します。 たとえば、アクションはスクリプトを実行したり、実行可能ファイルを起動したり、ドキュメントの名前が指定されている場合は、関連付けられているアプリケーションを見つけて、ドキュメントでアプリケーションを起動したりできます。
TASK_ACTION_COM_HANDLER
5
このアクションはハンドラーを起動します。
TASK_ACTION_SEND_EMAIL
6
このアクションにより、電子メール メッセージが送信されます。
TASK_ACTION_SHOW_MESSAGE
7
このアクションには、メッセージ ボックスが表示されます。

[out] ppAction

新しいアクションを表す IAction インターフェイス。

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

戻り値

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

備考

コレクションに 32 個を超えるアクションを追加することはできません。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー taskschd.h
ライブラリ Taskschd.lib
DLL Taskschd.dll

関連項目

IAction の

IActionCollection

IComHandlerAction

IEmailAction の

IExecAction の

IShowMessageAction

TASK_ACTION_TYPE

タスク スケジューラ の