IVMTask-Schnittstelle
[Windows Der virtuelle PC ist ab diesem Zeitraum nicht mehr Windows 8. 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 diese Typen von Membern:
Methoden
Die IVMTask-Schnittstelle verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Abbrechen | Bricht die Aufgabe ab. |
| WaitForCompletion | Wartet, bis der Task abgeschlossen ist oder das angegebene Time out-Intervall verstreicht. |
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 diesen Task aufgezeichnete Fehler. |
| ErrorDescription |
Schreibgeschützt |
Die lokalisierte Fehlerbeschreibung, die für diesen Task aufgezeichnet wurde. |
| Id |
Schreibgeschützt |
Ein eindeutiger Bezeichner für diesen Task. |
| Iscancelable |
Schreibgeschützt |
Gibt an, ob der Task abgebrochen werden kann. |
| IsComplete |
Schreibgeschützt |
Gibt an, ob die Aufgabe abgeschlossen wurde. |
| PercentCompleted |
Schreibgeschützt |
Der Abschlussprozentsatz der Aufgabe. |
| Ergebnis |
Schreibgeschützt |
Das Ergebnis der Aufgabe. |
Hinweise
Ein IVMTask-Objekt wird von Methoden zurückgegeben, die möglicherweise einen erheblichen Zeitraum für den Abschluss benötigen. 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 [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Ende des Supports (Client) |
Windows 7 |
| Product (Produkt) |
Windows Virtual PC |
| Header |
|
| IID |
IID _ IVMTask ist als ab72b222-6e9c-48ae-aa54-85e3e635767c definiert. |