IVMVirtualPC::DeleteVirtualMachine method

[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