Edit

IVMVirtualPC::DeleteVirtualMachine method

  • Article

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

Deletes a virtual machine configuration.

Syntax

HRESULT DeleteVirtualMachine(
  [in] IVMVirtualMachine *virtualMachine
);

Parameters

virtualMachine [in]

A pointer to an IVMVirtualMachine object representing the virtual machine configuration to be deleted.

Return value

This method can return one of these values.

Return code/value Description
S_OK
0
 The operation was successful.
S_FALSE
1
 The specified configuration could not be found.
E_POINTER
0x80004003
 The virtualMachine parameter was NULL.
VM_E_VM_RUNNING
0xA0040500
 The virtual machine is running.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 The processor does not support Hardware Accelerated Virtualization (HAV) extensions.
DISP_E_EXCEPTION
0x80020009
 An unexpected error has occurred.

Remarks

Only stopped virtual machines can be deleted. Note that any existing saved state or undo drive data for this configuration will be deleted in addition to the configuration file.

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_IVMVirtualPC is defined as 236ba0d9-a24a-4292-a132-27c1421dfd01

See also

IVMVirtualPC