Edit C:\Program Files (x86)\VMware\VMware VIX\doc\lang\perl\functions\VMCreateSnapshot.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>VMCreateSnapshot</b>
<h1>Description</h1>
<pre>
($err, $snapshotHandle) = VMCreateSnapshot($vmHandle,
                                           $name,
                                           $description,
                                           $options,
                                           $propertyListHandle);
</pre>
<p>
This
function
saves a copy of the virtual machine state as a snapshot object.
<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>name</i></dt>
<dd>
A user-defined name for the snapshot; need not be unique.
</dd>
<dt><i>description</i></dt>
<dd>
A user-defined description for the snapshot.
</dd>
<dt><i>options</i></dt>
<dd>
Flags to specify how the snapshot should be created. Any
             combination of the following or 0 to exclude memory:
<ul>
<li> VIX_SNAPSHOT_INCLUDE_MEMORY - Captures the full state of a
running virtual machine, including the memory.
</ul>
</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 &gt; Error Codes.
<p>
$snapshotHandle.  A handle to the newly created snapshot.
<h1>Remarks</h1>
<ul>
<li> This function creates a child snapshot of the current snapshot.
<li> If a virtual machine is suspended, you cannot snapshot it more than once.
<li> If a powered-on virtual machine gets a snapshot created with option 0 (exclude memory),
the power state is not saved, so reverting to the snapshot sets powered-off state.
<li> The 'name' and 'description' parameters can be set but not retrieved
using the VIX API.
<li> VMware Server supports only a single snapshot for each virtual machine.
The following considerations apply to VMware Server:
<ul>
<li> If you call this function a second time for the same virtual machine
without first deleting the snapshot, the second call will overwrite
the previous snapshot.
<li> A virtual machine imported to VMware Server from another VMware product
might have more than one snapshot at the time it is imported.
In that case, you can use this function to add a new snapshot to the
series.
</ul>
<li> Starting in VMware Workstation 6.5, snapshot operations are allowed on
virtual machines that are part of a team.  Previously, this operation failed
with error code VIX_PROPERTY_VM_IN_VMTEAM.  Team members snapshot independently
so they can have different and inconsistent snapshot states.
<li> This function is not supported when using the
VIX_SERVICEPROVIDER_VMWARE_PLAYER
host type.
<li> If the virtual machine is open and powered off in the UI, this function
now closes the virtual machine in the UI before creating the snapshot.
</ul>
<h1>Side Effects</h1>
None.
<h1>Requirements</h1>
<pre>
use VMware::Vix::Simple;
use VMware::Vix::API::Constants;
</pre>
since VMware Workstation 6.0
<h1>Example</h1>
<pre>
my $err = VIX_OK;
my $hostHandle = VIX_INVALID_HANDLE;
my $vmHandle = VIX_INVALID_HANDLE;
my $snapshotHandle = VIX_INVALID_HANDLE;

($err, $hostHandle) = HostConnect(VIX_API_VERSION,
                                  VIX_SERVICEPROVIDER_VMWARE_WORKSTATION,
                                  undef, # hostName
                                  0, # hostPort
                                  undef, # userName
                                  undef, # password
                                  0, # options
                                  VIX_INVALID_HANDLE); # propertyListHandle

die "HostConnect() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

($err, $vmHandle) = VMOpen($hostHandle,
                           "c:\\Virtual Machines\\vm1\\win2000.vmx");
die "VMOpen() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

$err = VMPowerOn($vmHandle,
                 VIX_VMPOWEROP_LAUNCH_GUI, # powerOnOptions
                 VIX_INVALID_HANDLE);  # propertyListHandle
die "VMPowerOn() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

# Create snapshot in powered-on state.
$(err, $snapshotHandle) = VMCreateSnapshot($vmHandle,
                                           undef, # name
                                           undef, # description
                                           VIX_SNAPSHOT_INCLUDE_MEMORY, # options
                                           VIX_INVALID_HANDLE);
</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