Name

Pause

Description

HRESULT
Pause(LONG pauseOptions,
      IVixHandle* propertyList,
      ICallback* jobDoneCallback,
      IJob** pauseJob);

This function pauses a virtual machine. See Remarks section for pause behavior when used with different operations.

Parameters

pauseOptions
Must be zero.
propertyList
Must be NULL (C++), null (C#), or Nothing (VB).
jobDoneCallback
An ICallback instance that will be called when the operation is complete.
pauseJob
Returns an IJob object that describes the state of this asynchronous operation.

Return Value

HRESULT

Remarks

Side Effects

None.

Requirements

VixCOM.h, since VMware Workstation 6.5

Example


VBScript:
Set job = vm.Pause(0, Nothing, Nothing)
' WaitWithoutResults is just like Wait, except it does not get any properties. 
err = job.WaitWithoutResults()
QuitIfError(err)

' Do something...

Set job = vm.Unpause(0, Nothing, Nothing)
' WaitWithoutResults is just like Wait, except it does not get any properties. 
err = job.WaitWithoutResults()
QuitIfError(err)

Set job = Nothing

Copyright (C) 2007-2011 VMware, Inc. All rights reserved.