Name

VixVM_Suspend

Description

VixHandle
VixVM_Suspend(VixHandle vmHandle,
              VixVMPowerOpOptions powerOffOptions,
              VixEventProc *callbackProc,
              void *clientData);

This function suspends a virtual machine.

Parameters

vmHandle
Identifies a virtual machine. Call VixVM_Open() to create a virtual machine handle.
powerOffOptions
Must be 0.
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 suspends a virtual machine. It is an asynchronous operation, and the job will be signaled when the operation completes. If the virtual machine is not powered on when you call this function, the function returns an error.

Side Effects

None.

Requirements

vix.h, since VMware Server 1.0
Copyright (C) 2007-2008 VMware, Inc. All rights reserved.