Edit C:\Program Files (x86)\VMware\VMware VIX\doc\lang\perl\functions\VMPause.html
<html> <head> <meta HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1"> <meta HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <link rel="stylesheet" href="../../../foundrydoc.css" type="text/css" charset="ISO-8859-1"> <link rel="stylesheet" href="foundrydoc.css" type="text/css" charset="ISO-8859-1"> </head> <body> <h1>Name</h1> <b>VMPause</b> <h1>Description</h1> <pre> $err = VMPause($vmHandle, $options, $propertyListHandle); </pre> <p> This function pauses a virtual machine. See Remarks section for pause behavior when used with different operations. <h1>Parameters</h1> <dl> <dt><i>vmHandle</i></dt> <dd> Identifies a virtual machine. Call VMOpen() to create a virtual machine handle. </dd> <dt><i>options</i></dt> <dd> Must be zero. </dd> <dt><i>propertyListHandle</i></dt> <dd> Must be VIX_INVALID_HANDLE. </dd> </dl> <h1>Return Value</h1> $err. The error code returned by the operation. For returned values, see Topics > Error Codes. <h1>Remarks</h1> <ul> <li> This stops execution of the virtual machine. <li> Functions that invoke guest operations should not be called when the virtual machine is paused. <li> Call VMUnpause to continue execution of the virtual machine. <li> Calling VMReset, VMPowerOff, and VMSuspend will successfully work when paused. The pause state is not preserved in a suspended virtual machine; a subsequent VMPowerOn will not remember the previous pause state. <li> Calling VMBeginRecording when paused is legal. The actual recording will start when the virtual machine is unpaused. <li> Do not call VMBeginReplay when the virtual machine is paused. To do so, call VMPowerOff first, which will reset the pause state. After the virtual machine is powered off, you can then call VMBeginReplay. <li> This function is not supported when using the VIX_SERVICEPROVIDER_VMWARE_PLAYER host type. </ul> <h1>Side Effects</h1> None. <h1>Requirements</h1> <pre> use VMware::Vix::Simple; use VMware::Vix::API::Constants; </pre> since VMware Workstation 6.5 <h1>Example</h1> <pre> my $err; my $snapshotHandle; my $vmHandle; # find the appropriate snapshot handle to replay # start the replay with the UI open $err = VMBeginReplay($vmHandle, $snapshotHandle, VIX_VMPOWEROP_LAUNCH_GUI, VIX_INVALID_HANDLE); die "VMBeginReplay() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK; # pause the replay $err = VMPause($vmHandle, 0, VIX_INVALID_HANDLE); die "VMPause() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK; # do something # unpause the replay $err = VMUnpause($vmHandle, 0, VIX_INVALID_HANDLE); die "VMUnpause() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK; </pre> </body> </html> <hr>Copyright (C) 2007-2017 VMware, Inc. All rights reserved.
Ms-Dos/Windows
Unix
Write backup
jsp File Browser version 1.2 by
www.vonloesch.de