IScheduledWorkItem::CreateTrigger メソッド (mstask.h)

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

作業項目のトリガーを作成します。

構文

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

[out] piNewTrigger

新しいトリガーの返されるトリガーインデックス値へのポインター。作業項目に関連付けられている最初のトリガーのトリガーインデックスは "0" です。トリガーインデックスのその他の用途については、「備考」を参照してください。

[out] ppTrigger

ITaskTrigger インターフェイスへのポインターへのポインター。現在、サポートされている作業項目はタスクのみです。

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

piNewTrigger によって返されるトリガーインデックスは、トリガーを取得または削除するときに使用します。ただし、トリガーインデックスは識別子ではありません。これは、作業項目に関連付けられている他の現在のトリガーに対する新しいトリガーの位置のみを示します。

新しいトリガーの条件を設定するには、 ITaskTrigger::SetTrigger を呼び出します。

作業項目の新しいトリガーを作成した後、アプリケーションは IPersistFile::Save メソッドを呼び出して、新しいトリガーをディスクに保存する必要があります。

新しいトリガーを作成するときにトリガー条件を設定する方法の例については、「新しいトリガーの作成」を参照してください。

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