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
• Eigenschaften

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	VPCCOMInterfaces.h
IID	IID_IVMTask ist definiert als ab72b222-6e9c-48ae-aa54-85e3e635767c