Name

VixVM_Reset

Description

VixHandle
VixVM_Reset(VixHandle vmHandle,
            VixVMPowerOpOptions powerOnOptions,
            VixEventProc *callbackProc,
            void *clientData);

This function resets a virtual machine, which is the equivalent of pressing the reset button on a physical machine.

Parameters

vmHandle: Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
powerOnOptions: Must be VIX_VMPOWEROP_NORMAL.
callbackProc: A callback function that will be invoked when the power operation is complete.
clientData: A parameter that will be passed to the callbackProc function.

Return Value

VixHandle. A job handle that describes the state of this asynchronous operation.

Remarks

This function resets a virtual machine, which is the equivalent of pressing the reset button on a physical machine. The reset is an asynchronous operation, and 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

vix.h, since VMware Server 1.0