ITaskTrigger::SetTrigger メソッド (mstask.h)

[[この API は、以降のバージョンのオペレーティング システムまたは製品で変更または使用できない場合があります。 代わりに タスク スケジューラ 2.0 インターフェイス を使用してください。] ]

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

構文

HRESULT SetTrigger(
  [in] const PTASK_TRIGGER pTrigger
);

パラメーター

[in] pTrigger

新しいタスク トリガーを定義する値を含む TASK_TRIGGER 構造体へのポインター。

戻り値

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

注釈

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

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

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

例

次のコードは、TASK_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);
}

要件

こちらもご覧ください

IPersistFile::Save

ITaskTrigger

ITaskTrigger::GetTrigger

TASK_TRIGGER