NewWorkItem を使用したタスクの作成の例
タスクを作成するときは、 ITaskScheduler と ITask の 2 つのタスク スケジューラ インターフェイスを使用 します。 タスクの一意の名前、タスク オブジェクトのクラス識別子、および ITask のインターフェイス識別子を指定する必要があります。 クラス識別子とインターフェイス識別子は、このトピックの後のコード例に示されています。
注意
ITaskScheduler::AddWorkItem を呼び出してタスクを作成することもできます。 このルートを取得するときは、 Task オブジェクトのインスタンス ( ITask インターフェイスをサポート) を作成し、指定した名前でタスクを追加する必要があります。
注意
既定では、Windows Server 2003 でタスクを作成できるのは、Administrators、Backup Operators、または Server Operators グループのメンバーだけです。 Administrators グループのメンバーは、他のユーザーがタスクを作成できるように、Windows\Task フォルダーのセキュリティ記述子を変更できます。
タスクに指定する名前は、スケジュールされたタスク フォルダー内で一意である必要があります。 同じ名前のタスクが既に存在する場合、 ITaskScheduler::NewWorkItem はERROR_FILE_EXISTSを返します。 この戻り値を取得する場合は、別の名前を指定し、タスクの作成を再試行する必要があります。
次の手順では、新しい作業項目タスクを作成する方法について説明します。
新しい作業項目タスクを作成するには
- CoInitialize を呼び出して COM ライブラリを初期化し、CoCreateInstance を呼び出してタスク スケジューラ オブジェクトを取得します。 (この例では、タスク スケジューラ サービスが実行されていることを前提としています)。
- ITaskScheduler::NewWorkItem を呼び出して、新しいタスクを作成します。 (このメソッドは 、ITask インターフェイスへのポインターを返します)。
- IPersistFile::Save を呼び出して、新しいタスクをディスクに保存します。 ( IPersistFile インターフェイスは、 ITask インターフェイスでサポートされている標準の COM インターフェイスです)。
- ITask::Release を呼び出して、すべてのリソースを解放します。 (Release は ITask によって継承された IUnknown メソッドであることに注意してください)。
| のコード例については、 | 参照先 |
|---|---|
| 1 つのタスクを作成する | C/C++ コード例: NewWorkItem を使用したタスクの作成 |
関連トピック