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 |
|
| IID |
IID_IVMTaskは ab72b222-6e9c-48ae-aa54-85e3e635767c として定義されます |