Edit

IVMVirtualMachine::MergeUndoDisks method

  • Article

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

Merges the virtual undo disks.

Syntax

HRESULT MergeUndoDisks(
  [out, retval] IVMTask **undoMergeTask
);

Parameters

undoMergeTask [out, retval]

An IVMTask object that is used to track the creation of the image.

Return value

This method can return one of these values.

Return code/value Description
S_OK
0
 The operation was successful.
DISP_E_EXCEPTION
0x80020009
 An unexpected error has occurred.
E_POINTER
0x80004003
 The parameter is NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 The system cannot find the path specified by the convertedDiskImagePath parameter or one of the parent disks is not valid.
E_ACCESSDENIED
0x80070005
 The current user has insufficient access to the parent file.
E_HANDLE
0x80070006
 One of the parent disks is in use.
VM_E_VM_UNKNOWN
0xA0040207
 The configuration is unknown.
VM_E_VM_RUNNING
0xA0040500
 The virtual machine is running.
VM_E_FILE_READ_ONLY
0xA004067A
 The parent of virtual undo disks is marked as read only.
DISP_E_EXCEPTION
0x80020009
 An unexpected error has occurred.

Remarks

MergeUndoDisks cannot be called while the virtual machine is still running. Use IVMVirtualMachine::Save to save the state of the virtual machine before calling MergeUndoDisks, or IVMVirtualMachine::TurnOff to turn off the virtual machine without saving its current state beforehand.

Requirements

Requirement Value
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