トリガー文字列の取得の例
操作しているオブジェクトの種類に応じて、 IScheduledWorkItem インターフェイスまたは ITaskTrigger インターフェイスを使用して、既知のトリガーのトリガー文字列を取得できます。
タスク オブジェクトを操作する場合は、IScheduledWorkItem インターフェイスのメソッドを使用して、作業項目のトリガー文字列を取得します。
タスク トリガー オブジェクトを操作する場合は、ITaskTrigger インターフェイスのメソッドを使用して、トリガーのトリガー文字列を取得します。
次の例は、 IScheduledWorkItem::GetTriggerString を使用して、既知のタスクに関連付けられているすべてのトリガーの文字列を表示する方法を示しています。
次の手順では、タスクのトリガー文字列を取得する方法について説明します。
タスクのトリガー文字列を取得するには
- CoInitialize を呼び出して COM ライブラリを初期化し、CoCreateInstance を呼び出してタスク スケジューラ オブジェクトを取得します。 (この例では、タスク スケジューラ サービスが実行されていることを前提としています)。
- ITaskScheduler::Activate を呼び出して、タスク オブジェクトの ITask インターフェイスを取得します。 (この例では、"テスト タスク" タスクを取得します。
- ITask::GetTriggerCount を呼び出して、タスクに関連付けられているトリガーの数を確認します。 (GetTriggerCount は ITask によって継承された IScheduledWorkItem メソッドであることに注意してください)。
- タスクに関連付けられている各トリガーの ITask::GetTriggerString を呼び出して、トリガー文字列を表示します。 (GetTriggerString は ITask によって継承された IScheduledWorkItem メソッドであることに注意してください)。
- すべてのリソースを解放します。 CoTaskMemFree を呼び出してトリガー文字列を解放し、ITask::Release を呼び出して ITask インターフェイスを解放します。 (Release は ITask によって継承された IUnknown メソッドであることに注意してください)。
のコード例については、 | 参照先 |
---|---|
既知のタスクに関連付けられているすべてのトリガーのトリガー文字列を取得する | コード例: トリガー文字列の取得 |
関連トピック