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
タスク スケジューラ の