次の方法で共有


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

タスクの新しいトリガーを作成します。

構文

HRESULT Create(
  [in]  TASK_TRIGGER_TYPE2 type,
  [out] ITrigger           **ppTrigger
);

パラメーター

[in] type

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

価値 意味
TASK_TRIGGER_EVENT
0
特定のイベントが発生したときにタスクをトリガーします。
TASK_TRIGGER_TIME
1
特定の時刻にタスクをトリガーします。
TASK_TRIGGER_DAILY
2
毎日のスケジュールでタスクをトリガーします。 たとえば、タスクは毎日、1 日おき、3 日ごとなど、特定の時刻に開始されます。
TASK_TRIGGER_WEEKLY
3
毎週のスケジュールでタスクをトリガーします。 たとえば、タスクは毎週または他の週の特定の日の午前 8 時に開始されます。
TASK_TRIGGER_MONTHLY
4
毎月のスケジュールでタスクをトリガーします。 たとえば、タスクは特定の月の特定の日に開始されます。
TASK_TRIGGER_MONTHLYDOW
5
毎月の曜日のスケジュールでタスクをトリガーします。 たとえば、タスクは、特定の曜日、月の週、および年の月に開始されます。
TASK_TRIGGER_IDLE
6
コンピューターがアイドル状態になったときにタスクをトリガーします。
TASK_TRIGGER_REGISTRATION
7
タスクが登録されたときにタスクをトリガーします。
TASK_TRIGGER_BOOT
8
コンピューターの起動時にタスクをトリガーします。
TASK_TRIGGER_LOGON
9
特定のユーザーがログオンしたときにタスクをトリガーします。
TASK_TRIGGER_SESSION_STATE_CHANGE
11
特定のセッション状態が変更されたときにタスクをトリガーします。

[out] ppTrigger

新しいトリガーを表す ITrigger インターフェイス。

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

戻り値

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

必要条件

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

関連項目

ITriggerCollection

タスク スケジューラ の