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

[アーティクル]
03/05/2024

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

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

構文

HRESULT SetTrigger(
  [in] const PTASK_TRIGGER pTrigger
);

パラメーター

[in] pTrigger

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

戻り値

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

リターンコード	説明
S_OK	操作に成功しました。
E_INVALIDARG	引数が無効です。
E_OUTOFMEMORY	メモリが不足しています。

注釈

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);
}

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mstask.h
Library	Mstask.lib
[DLL]	Mstask.dll
再頒布可能パッケージ	Windows NT 4.0 および Windows 95 のインターネットエクスプローラー 4.0 以降