Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]
Unregisters a virtual machine (VM) configuration without deleting the configuration file.
Syntax
HRESULT UnregisterVirtualMachine(
[in] IVMVirtualMachine *virtualMachine
);
Parameters
-
virtualMachine [in]
-
A pointer to an IVMVirtualMachine object that represents the VM configuration to be unregistered.
Return value
This method can return one of these values.
| Return code/value | Description |
|---|---|
|
The operation was successful. |
|
The virtualMachine parameter was NULL. |
|
The VM is running. |
|
The processor does not support Hardware Accelerated Virtualization (HAV) extensions. |
|
An unexpected error has occurred. |
Remarks
Only stopped VMs can be unregistered. Existing saved state or undo drive data for this configuration will be retained when a VM is unregistered.
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 |
|
| IID |
IID_IVMVirtualPC is defined as 236ba0d9-a24a-4292-a132-27c1421dfd01 |