ITaskTrigger

タスクのトリガーへのアクセスと設定を行うためのメソッドを提供します。トリガーは、タスクの開始時刻、繰り返し条件、およびタスクの実行タイミングを制御するその他のパラメーターを指定します。

SetTrigger メソッドは、タスクトリガーのトリガー条件を設定します。

SetTrigger メソッドは、次のいずれかの値を返します。

TASK_TRIGGER 構造体の wBeginDay、wBeginMonth、wBeginYear の各メンバーには、それぞれ有効な日、月、年を設定する必要があります。

1 つのタスクには任意の数のトリガーを関連付けることができます。タスクが実行される時刻は、そのタスクに定義されたすべてのトリガーの和集合になります。

これらの新しいトリガー設定でタスクを更新するには、アプリケーションは SetTrigger を呼び出した後に IPersistFile::Save メソッドを呼び出す必要があります。

Examples

次のコードは、このメソッドの変数宣言と呼び出し構文を、 TASK_TRIGGER の必須メンバーを含めて示しています。新しいトリガーを作成する際のトリガー条件の設定については、Creating a New Trigger を参照してください。

HRESULT hr = S_OK;

TASK_TRIGGER Trigger;

ZeroMemory(&Trigger, sizeof(TASK_TRIGGER));

Trigger.cbTriggerSize = sizeof(TASK_TRIGGER);
Trigger.wBeginDay = 1;
Trigger.wBeginMonth = 1;
Trigger.wBeginYear = 1999;

// pITaskTrigger is a previously assigned ITaskTrigger pointer.
hr = pITaskTrigger->SetTrigger(&Trigger);
if (FAILED(hr))
{
   printf("Failed SetTrigger\n");
   exit(1);
}

GetTrigger メソッドは、現在のタスクトリガーを取得します。

GetTrigger メソッドは、次のいずれかの値を返します。

スケジュールされた作業項目には、1 つ以上のトリガーを定義できます。作業項目が実行される時刻は、その項目に定義されたすべてのトリガーの和集合になります。

GetTriggerString メソッドは、現在のタスクトリガーを文字列の形式で取得します。この文字列は、タスク スケジューラのユーザーインターフェイスに "At 2PM every day, starting 5/11/97." のような形式で表示されます。

GetTriggerString メソッドは、次のいずれかの値を返します。