IRDVTaskPlugin インターフェイス

IRDVTaskPlugin インターフェイスは、仮想マシンのシステム更新プログラムをタスクエージェントが管理できるように、仮想マシンの更新タスク エージェントによって実装されます。このインターフェイスは、ホストシステムによって実装される トリガーエージェントによって使用されます。

メンバー

IRDVTaskPlugin インターフェイスは、IUnknown インターフェイスから継承されます。 IRDVTaskPlugin には、次の種類のメンバーもあります。

IRDVTaskPlugin インターフェイスには、これらのメソッドがあります。

メソッド	説明
初期化する	タスクエージェントを初期化するために呼び出されます。
StartTask	仮想マシンで更新タスクを開始するために呼び出されます。
Terminate	タスクエージェントがシャットダウンされるときに呼び出されます。

IRDVTaskPlugin インターフェイスには、これらのプロパティがあります。

プロパティ	アクセスの種類	説明
PluginName	読み取り専用	タスクエージェントの表示名を格納します。

タスクエージェントは、その仮想マシンがシステム更新用にスケジュールされている場合に、仮想マシン上で実行されます。タスクエージェントは、 StartTask メソッドが呼び出されたときに仮想マシンを更新します。

タスクエージェントを登録するには、仮想マシンのレジストリに次のキーを追加します。

Hkey_local_machine\ソフトウェア\マイクロソフト\\ Windows NT CurrentVersion\ターミナルサーバー\タスク\プラグイン\TaskAgentName

このレジストリキーの下に、次の値を追加します。

名前	Type	説明
CLSID	REG_SZ	タスクエージェントの CLSID を表す文字列。
IsEnabled	REG_DWORD	タスクエージェントが無効になっている場合は 0、タスクエージェントが有効になっている場合は 1。

Note

複数のタスクエージェントを登録できますが、使用されるタスクエージェントは 1 つだけです。複数のタスクエージェントが有効になっている場合は、最初に見つかったタスクエージェントのみが使用されます。

このインターフェイスは、以下の要件で示されているオペレーティングシステムでサポートされていますが、仮想マシンがWindows Server 2012でホストされている場合にのみ使用されます。

要件	値
サポートされている最小のクライアント	Windows 7 Enterprise
サポートされている最小のサーバー	Windows Server 2008 R2