CHAPTER 4 Operations on Virtual Machines
59
RC1
VixVM_PowerOn
Function Signature
VixHandle
VixVM_PowerOn(VixHandle vmHandle,
VixVMPowerOpOptions powerOnOptions,
VixHandle propertyListHandle,
VixEventProc *callbackProc,
void *clientData);
Parameters
Results
VixHandle — A job handle that describes the state of this asynchronous operation.
Notes
• This function powers on a virtual machine. It is an asynchronous operation, and
the job will be signalled when the operation completes. If the virtual machine is
already powered on when you call this function, then the function returns an
error.
• When you power on a virtual machine, VMware Server launches the console to
display the virtual machine.
• This function can also be used to resume execution of a suspended virtual
machine.
Example
VixError err = VIX_OK;
VixHandle hostHandle = VIX_INVALID_HANDLE;
VixHandle jobHandle = VIX_INVALID_HANDLE;
VixHandle vmHandle = VIX_INVALID_HANDLE;
vmHandle Identifies a virtual machine. Call VixVM_Open() to create a virtual
machine handle.
powerOnOptions Must be VIX_VMPOWEROP_NORMAL.
propertyListHandle Must be VIX_INVALID_HANDLE.
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.
