title | description | ms.assetid | keywords | topic_type | api_name | api_location | api_type | ms.topic | ms.date | |||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
IVMVirtualMachine Startup2 method (VPCCOMInterfaces.h) |
Starts the virtual machine from either the uninitialized or saved state, with advanced options. |
c2679ea1-bbd5-42dc-9326-2019ad99554c |
|
|
|
|
|
reference |
05/31/2018 |
[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]
Starts the virtual machine (VM) from either the uninitialized or saved state, with advanced options.
This method provides a mechanism to start a VM with a differencing disk even if the parent disk's timestamp has been changed.
HRESULT Startup2(
[in] VMStartupOption startupOption,
[out, retval] IVMTask **startupTask
);
-
startupOption [in]
-
The advanced startup option. The possible values are from the VMStartupOption enumeration.
-
startupTask [out, retval]
-
An IVMTask object that is used to track the completion progress of the start sequence.
This method can return one of these values.
Return code/value | Description |
---|---|
|
The operation was successful. |
|
The startupOption parameter is not valid. |
|
The startupTask parameter is NULL. |
|
The caller must have execute access permissions to start this VM. |
|
The operation did not complete in a timely manner. |
|
There are not enough host resources. |
|
There are too many active VMs. |
|
The VM is already running. |
|
An unexpected error has occurred. |
The following values can be returned through the Error property of the returned IVMTask object.
Error code/Value | Description |
---|---|
VM_E_UNSUPPORTED_HARDWARE (0xA0040950) |
The hardware does not support virtualization. |
VM_E_HARDWARE_VIRTUALIZATION_DISABLED (0xA0040951) |
Hardware virtualization is disabled. |
VM_E_VMVIRTUALPC_OLDER_VERSION (0xA0040952) |
Both Virtual PC 2007 and Windows Virtual PC are installed. |
VM_E_OTHER_VIRTUALIZATION_SOFTWARE (0xA0040953) |
Other virtualization software is installed. |
VM_E_OUT_OF_RESOURCE (0xa00400203) |
There are not enough host resources. |
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_IVMVirtualMachine is defined as f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |