Export (0) Print
Expand All

IVMVirtualMachine::ShutdownActionOnQuit property

Windows Virtual PC

[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/valueMeaning
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

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft