Edit

IVMVirtualMachine::ShutdownActionOnQuit property

  • Article

[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
S_OK
0
 The operation was successful.
E_POINTER
0x80004003
 The parameter is NULL or not a valid value.
E_ACCESSDENIED
0x80070005
 The current user has insufficient access to the configuration file.
VM_E_VM_UNKNOWN
0xA0040207
 The configuration is unknown.
DISP_E_EXCEPTION
0x80020009
 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
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine is defined as f7092aa1-33ed-4f78-a59f-c00adfc2edd7

See also

IVMVirtualMachine

VMShutdownAction