トリガー文字列の取得の例

  • [アーティクル]

操作しているオブジェクトの種類に応じて、 IScheduledWorkItem インターフェイスまたは ITaskTrigger インターフェイスを使用して、既知のトリガーのトリガー文字列を取得できます。

タスク オブジェクトを操作する場合は、IScheduledWorkItem インターフェイスのメソッドを使用して、作業項目のトリガー文字列を取得します。

タスク トリガー オブジェクトを操作する場合は、ITaskTrigger インターフェイスのメソッドを使用して、トリガーのトリガー文字列を取得します。

次の例は、 IScheduledWorkItem::GetTriggerString を使用して、既知のタスクに関連付けられているすべてのトリガーの文字列を表示する方法を示しています。

次の手順では、タスクのトリガー文字列を取得する方法について説明します。

タスクのトリガー文字列を取得するには

  1. CoInitialize を呼び出して COM ライブラリを初期化し、CoCreateInstance を呼び出してタスク スケジューラ オブジェクトを取得します。 (この例では、タスク スケジューラ サービスが実行されていることを前提としています)。
  2. ITaskScheduler::Activate を呼び出して、タスク オブジェクトの ITask インターフェイスを取得します。 (この例では、"テスト タスク" タスクを取得します。
  3. ITask::GetTriggerCount を呼び出して、タスクに関連付けられているトリガーの数を確認します。 (GetTriggerCount は ITask によって継承された IScheduledWorkItem メソッドであることに注意してください)。
  4. タスクに関連付けられている各トリガーの ITask::GetTriggerString を呼び出して、トリガー文字列を表示します。 (GetTriggerString は ITask によって継承された IScheduledWorkItem メソッドであることに注意してください)。
  5. すべてのリソースを解放します。 CoTaskMemFree を呼び出してトリガー文字列を解放し、ITask::Release を呼び出して ITask インターフェイスを解放します。 (Release は ITask によって継承された IUnknown メソッドであることに注意してください)。
のコード例については、 参照先
既知のタスクに関連付けられているすべてのトリガーのトリガー文字列を取得する コード例: トリガー文字列の取得

 

タスク スケジューラ 1.0 の例