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).]
Retrieves and sets the action to be performed on this virtual machine (VM) if it is running when Windows Virtual PC is quit.
This property is read/write.
Syntax
HRESULT put_ShutdownActionOnQuit(
[in] VMShutdownAction shutdownAction
);
HRESULT get_ShutdownActionOnQuit(
[out, retval] VMShutdownAction *shutdownAction
);
Property value
Specifies how to shut down this VM if it is running when Windows Virtual PC is quit. For a list of values, see VMShutdownAction.
Error codes
| Name/value | Meaning |
|---|---|
|
The operation was successful. |
|
The parameter is NULL or not a valid value. |
|
The current user has insufficient access to the configuration file. |
|
The configuration is unknown. |
|
An unexpected error has occurred. |
Remarks
By default, running VMs are saved when Windows Virtual PC is quit. The shutdown action vmShutdownAction_Save (0) will save the VM's state. The vmShutdownAction_TurnOff (1) action will turn off the VM. The vmShutdownAction_Shutdown (2) action will shut down the guest operating system if the integration components are available and will save the VM otherwise.
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_IVMVirtualMachine is defined as f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |