Name
Reset
Description
HRESULT
Reset([in] LONG resetOptions,
[in] ICallback* jobDoneCallback,
[out,retval] IJob** resetJob);
This function resets a virtual machine.
Parameters
- resetOptions
-
Must be VixCOM.Constants.VIX_VMPOWEROP_NORMAL or
VixCOM.Constants.VIX_VMPOWEROP_FROM_GUEST.
- jobDoneCallback
-
An ICallback instance that will be called when the
operation is complete.
- resetJob
-
Returns an IJob object that describes the state of this asynchronous operation.
Return Value
HRESULT
Remarks
- If you pass VIX_VMPOWEROP_NORMAL as the options, this function is the
equivalent of pressing the reset button on a physical machine.
- The VIX_VMPOWEROP_FROM_GUEST flag will cause the function to try to reset
the guest OS. This will ensure a clean shutdown of the guest. This option
requires that the VMware Tools be installed and running in the guest.
- The reset is an asynchronous operation. The job will be signalled when the
operation completes.
- If the virtual machine is not powered on when you call this function, it returns
an error.
Side Effects
None.
Requirements
VixCOM.h, since VMware Workstation 6.0