作業項目プロパティの取得の例
作業項目のプロパティを取得するには、 ITaskScheduler::Activate を呼び出して作業項目オブジェクトのインターフェイスを取得し、目的のタスク プロパティを取得する適切なメソッドを呼び出します。 現在、有効な作業項目はタスクのみです。
このページの下部に示されているコード例は、すべての作業項目に適用されるプロパティを取得する方法を示しています。 タスクに固有のその他のプロパティについては、「 タスク プロパティの設定の例」を参照してください。
注意
次のコード例では、すべてのインターフェイスは不要になった後にリリースされます。
文字列プロパティ (作業項目のコメントなど) を取得する場合は、 CoTaskMemFree を呼び出して、返される文字列に割り当てられたメモリを解放する必要があることに注意してください。
次の手順では、タスク プロパティを取得する方法について説明します。
タスク プロパティを取得するには
- CoInitialize を呼び出して COM ライブラリを初期化し、CoCreateInstance を呼び出してタスク スケジューラ オブジェクトを取得します。 (これらの例では、タスク スケジューラ サービスが実行されていることを前提としています)。
- ITaskScheduler::Activate を呼び出して、タスク オブジェクトの ITask インターフェイスを取得します。 (現在、タスクは唯一の有効な種類の作業項目であることに注意してください)。
- 目的のプロパティを取得するには、適切なメソッドを呼び出します。
- 必要に応じて プロパティを処理します。 (これらの例では、 プロパティを画面に出力するだけです)。
- 返されたプロパティが文字列の場合は、 CoTaskMemFree を呼び出して、返される文字列に割り当てられたメモリを解放します。
| のコード例については、 | 参照先 |
|---|---|
| 既知のタスクのアカウント情報の取得 | C/C++ コード例: タスク アカウント情報の取得 |
| 既知のタスクのコメント文字列の取得 | C/C++ コード例: タスク コメントの取得 |
| タスクの作成者の名前を取得し、画面に表示する | C/C++ コード例: タスク作成者の取得 |
| 既知のタスクによって返された最後の終了コードの取得 | C/C++ コード例: タスク終了コードの取得 |
| タスクのアイドル待機時間を取得し、画面に表示する | C/C++ コード例: タスクのアイドル待機時間の取得 |
| タスクが最後に実行された時刻を取得し、画面に表示する | C/C++ コード例: タスク MostRecentRun Time の取得 |
| 次回タスクの実行がスケジュールされている時刻を取得し、その時刻を画面に表示する | C/C++ コード例: タスク NextRun Time の取得 |
| タスクの実行時間を取得し、画面に表示する | C/C++ コード例: タスクの実行時間の取得 |
| タスクの現在の状態を取得し、画面に表示する | C/C++ コード例: タスクの状態の取得 |
関連トピック