IVMVirtualMachine::Save method

Windows Virtual PC

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Saves the virtual machine (VM) state.

Syntax


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

Parameters

saveTask [out, retval]

An IVMTask object that is used to track the completion progress of the VM's state saving sequence.

Return value

This method can return one of these values.

Return code/valueDescription
S_OK
0

The operation was successful.

E_FAIL
0x80004005

The VM could not be saved because the undo disks were marked for deletion.

E_POINTER
0x80004003

The parameter is NULL.

HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
0x80070005

The caller must have execute access permissions to save the state of this VM.

VM_E_VM_NOT_RUNNING
0xA0040206

The VM is not running.

DISP_E_EXCEPTION
0x80020009

An unexpected error has occurred.

 

Remarks

The VM is turned off when the Save task reaches completion. The IVMVirtualMachine::State property will contain vmVMState_Saving while the save is in progress, followed by vmVMState_Saved when the save has completed and the VM is turned off.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

None supported

End of client support

Windows 7

Product

Windows Virtual PC

Header

VPCCOMInterfaces.h

IID

IID_IVMVirtualMachine is defined as f7092aa1-33ed-4f78-a59f-c00adfc2edd7

See also

IVMVirtualMachine

 

 

Community Additions

ADD
Show: