ITaskScheduler

タスクをスケジュールするためのメソッドを提供します。

SetTargetComputer メソッドは、ITaskScheduler インターフェイスが操作対象とするコンピューターを選択し、リモートでのタスク管理と列挙を可能にします。

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

Windows Server 2003 または Windows XP のコンピューターが Windows Vista のコンピューター上のタスクを作成、監視、または制御するには、Windows Vista のコンピューターで以下の操作を完了しておく必要があり、また ITaskScheduler::SetTargetComputer メソッドを呼び出すユーザーは、リモートの Windows Vista コンピューター上の Administrators グループのメンバーである必要があります。

Windows ファイアウォールで「ファイルとプリンターの共有」の例外を有効にする

1. ［スタート］をクリックし、［コントロール パネル］をクリックします。
2. コントロール パネルで クラシック表示 をクリックし、Windows ファイアウォール アイコンをダブルクリックします。
3. Windows ファイアウォールのウィンドウで ［例外］ タブをクリックし、［ファイルとプリンターの共有］の例外 のチェック ボックスをオンにします。

「Remote Registry」サービスを有効にする

• コマンド プロンプト ウィンドウを開き、次のコマンドを入力します: net start "Remote Registry"

GetTargetComputer メソッドは、現在 ITaskScheduler が対象としているコンピューターの名前を返します。

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

Enum メソッドは、現在のタスク フォルダー内のタスクを列挙する OLE 列挙子オブジェクトへのポインターを取得します。

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

既定では、現在のフォルダーはローカルコンピューター上に存在します。リモートコンピューターの場合は、 ITaskScheduler::GetTargetComputer を呼び出し、この呼び出しで返される名前を使用します。対象コンピューターを変更するには、 ITaskScheduler::SetTargetComputer を呼び出します。

Activate メソッドは、指定した作業項目に対するアクティブなインターフェイスを返します。

このメソッドが成功すると、S_OK が返されます。

メソッドが失敗した場合は、次のいずれかのエラー コードが返されることがあります。

Delete メソッドは、タスクを削除します。

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

NewWorkItem メソッドは、新しい作業項目を作成し、その作業項目のための領域を割り当てて、そのアドレスを取得します。

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

このメソッドは、新しい作業項目を作成する際にメモリの割り当てを自動的に処理します。

作業項目をディスクに保存するには、 IPersistFile::Save を呼び出します。この COM インターフェイスは、すべての作業項目インターフェイスでサポートされています (現時点では ITask が唯一サポートされている作業項目インターフェイスです)。

Task Scheduler は、作業項目を追加するために 2 つのメソッド、 NewWorkItem と AddWorkItem を提供します。これらのメソッドには、それぞれ固有の利点があります。 AddWorkItem は名前の衝突を防ぎますが、呼び出しごとに 2 回のディスク書き込み操作を必要とします。1 回目の書き込み操作は、 AddWorkItem の呼び出しによってディスク上に空の作業項目オブジェクトが作成されるときに実行され、その後、IPersistFile::Save が呼び出されるときにもう 1 回の書き込み操作が実行されます。

タスクは、AddWorkItem または NewWorkItem を呼び出して作成できます。AddWorkItem を使用する場合は、Task オブジェクト (ITask インターフェイスをサポートします) のインスタンスを作成し、指定した名前でタスクを追加する責任は呼び出し元にあります。

NewWorkItem は名前の衝突を防ぎませんが、IPersistFile::Save が呼び出されるときに必要となるディスク書き込み操作は 1 回だけです。 NewWorkItem はディスク書き込み操作の面ではより効率的ですが、IPersistFile::Save が呼び出される前に別のアプリケーションが同じ名前の作業項目を作成してしまうリスクがあります。

AddWorkItem メソッドは、タスクのスケジュールにタスクを追加します。

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

Task Scheduler は、作業項目を追加するために 2 つのメソッド、 NewWorkItem と AddWorkItem を提供します。これらのメソッドには、それぞれ固有の利点があります。 AddWorkItem は名前の衝突を防ぎますが、呼び出しごとに 2 回のディスク書き込み操作を必要とします。1 回目の書き込み操作は、 AddWorkItem の呼び出しによってディスク上に空の作業項目オブジェクトが作成されるときに実行され、その後、IPersistFile::Save が呼び出されるときにもう 1 回の書き込み操作が実行されます。

NewWorkItem は名前の衝突を防ぎませんが、IPersistFile::Save が呼び出されるときに必要となるディスク書き込み操作は 1 回だけです。 NewWorkItem はディスク書き込み操作の面ではより効率的ですが、IPersistFile::Save が呼び出される前に別のアプリケーションが同じ名前の作業項目を作成してしまうリスクがあります。

IsOfType メソッドは、オブジェクトの型を調べて、特定のインターフェイスをサポートしているかどうかを確認します。

IsOfType メソッドは、pwszName で指定されたオブジェクトが riid で指定されたインターフェイスをサポートしている場合に S_OK を返します。それ以外の場合は S_FALSE が返されます。