IVMVirtualMachine::Save-Methode

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Speichert den VM-Zustand.

Syntax

HRESULT Save(
  [out, retval] IVMTask **saveTask
);

Parameter

saveTask [out, retval]

Ein IVMTask-Objekt , das verwendet wird, um den Abschlussfortschritt der Zustandsspeichersequenz des virtuellen Computers nachzuverfolgen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0	Der Vorgang wurde durchgeführt.
E_FAIL 0x80004005	Die VM konnte nicht gespeichert werden, da die Rückgängig-Datenträger zum Löschen markiert wurden.
E_POINTER 0x80004003	Der Parameter ist NULL.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	Der Aufrufer muss über Ausführungszugriffsberechtigungen verfügen, um den Zustand dieser VM zu speichern.
VM_E_VM_NOT_RUNNING 0xA0040206	Der virtuelle Computer wird nicht ausgeführt.
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Die VM wird deaktiviert, wenn der Task Speichern abgeschlossen ist. Die IVMVirtualMachine::State-Eigenschaft enthält vmVMState_Saving , während die Speicherung ausgeführt wird, gefolgt von vmVMState_Saved , wenn der Speichervorgang abgeschlossen und die VM deaktiviert ist.

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_IVMVirtualMachine ist definiert als f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Siehe auch

IVMVirtualMachine