IVMTask-Schnittstelle
[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]
Verwenden Sie die IVMTask-Schnittstelle , um asynchrone Aufgaben für verschiedene COM-Methoden zu überwachen und zu steuern.
Member
Die IVMTask-Schnittstelle erbt von der IDispatch-Schnittstelle . IVMTask verfügt auch über folgende Membertypen:
Methoden
Die IVMTask-Schnittstelle verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| Abbrechen | Bricht die Aufgabe ab. |
| WaitForCompletion | Wartet, bis die Aufgabe abgeschlossen ist oder das angegebene Timeoutintervall verstrichen ist. |
Eigenschaften
Die IVMTask-Schnittstelle verfügt über diese Eigenschaften.
| Eigenschaft | Zugriffstyp | BESCHREIBUNG |
|---|---|---|
|
Beschreibung |
Schreibgeschützt |
Eine Beschreibung des Tasks. |
|
Fehler |
Schreibgeschützt |
Der für diese Aufgabe aufgezeichnete Fehler. |
|
ErrorDescription |
Schreibgeschützt |
Die lokalisierte Fehlerbeschreibung, die für diesen Task aufgezeichnet wurde. |
|
id |
Schreibgeschützt |
Ein eindeutiger Bezeichner für diese Aufgabe. |
|
Iscancelable |
Schreibgeschützt |
Gibt an, ob die Aufgabe abgebrochen werden kann. |
|
IsComplete |
Schreibgeschützt |
Gibt an, ob die Aufgabe abgeschlossen wurde. |
|
PercentCompleted |
Schreibgeschützt |
Der Abschlussprozentsatz des Vorgangs. |
|
Ergebnis |
Schreibgeschützt |
Das Ergebnis der Aufgabe. |
Bemerkungen
Ein IVMTask-Objekt wird von Methoden zurückgegeben, deren Abschluss möglicherweise viel Zeit in Anspruch nimmt. Dadurch kann die Anwendung den Fortschritt des gewünschten Vorgangs überwachen, ohne die weitere Ausführung zu blockieren, während auf den Abschluss des Vorgangs gewartet wird.
Die folgenden Methoden geben ein IVMTask-Objekt zurück, das zum Nachverfolgen des Fortschritts verwendet werden kann:
- 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
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Ende des Supports (Client) |
Windows 7 |
| Produkt |
Windows Virtual PC |
| Header |
|
| IID |
IID_IVMTask ist definiert als ab72b222-6e9c-48ae-aa54-85e3e635767c |