IVMTask インターフェイス

[Windows Virtual PC は、Windows 8の時点で使用できなくなります。 代わりに、 Hyper-V WMI プロバイダー (V2)を使用します。

IVMTask インターフェイスを使用して、さまざまな COM メソッドの非同期タスクを監視および制御します。

メンバー

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

• メソッド
• プロパティ

メソッド

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

メソッド	説明
キャンセル	タスクを取り消します。
WaitForCompletion	タスクが完了するか、指定したタイムアウト間隔が経過するまで待機します。

プロパティ

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

プロパティ	アクセスの種類	説明
説明	読み取り専用	タスクの説明。
エラー	読み取り専用	このタスクに記録されたエラー。
ErrorDescription	読み取り専用	このタスクに対して記録されたローカライズされたエラーの説明。
id	読み取り専用	このタスクの一意識別子。
IsCancelable	読み取り専用	タスクを取り消すことができるかどうかを示します。
IsComplete	読み取り専用	タスクが完了したかどうかを示します。
PercentCompleted	読み取り専用	タスクの完了率。
結果	読み取り専用	タスクの結果。

解説

IVMTask オブジェクトは、完了までにかなりの時間が必要になる可能性があるメソッドによって返されます。 これにより、アプリケーションは、操作の完了を待機している間に、必要な操作の進行状況を監視し、それ以上の実行をブロックする必要はありません。

次のメソッドは、進行状況の追跡に使用できる IVMTask オブジェクトを返します。

• IVMGuestOS::Logoff
• IVMGuestOS::Restart
• IVMGuestOS::Shutdown
• IVMHardDisk::Compact
• IVMHardDisk::Convert
• IVMHardDisk::Merge
• IVMHardDisk::MergeTo
• IVMVirtualMachine::MergeUndoDisks
• IVMVirtualMachine::Reset
• IVMVirtualMachine::Save
• IVMVirtualMachine::Startup
• IVMVirtualMachine::Startup2
• IVMVirtualMachine::TurnOff
• IVMVirtualPC::CreateDifferencingVirtualHardDisk
• IVMVirtualPC::CreateDynamicVirtualHardDisk
• IVMVirtualPC::CreateFixedVirtualHardDisk

必要条件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
クライアント サポートの終了	Windows 7
製品	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMTaskは ab72b222-6e9c-48ae-aa54-85e3e635767c として定義されます