Name

VMEndReplay

Description

$err = VMEndReplay($vmHandle, $options, $propertyListHandle);

This function stops replaying a virtual machine's recording.

Parameters

vmHandle: Identifies a virtual machine. Call VMOpen() to create a virtual machine handle.
options: Must be zero.
propertyListHandle: Must be VIX_INVALID_HANDLE.

Return Value

$err. The error code returned by the operation. For returned values, see Topics > Error Codes.

Remarks

Record-replay functionality has been deprecated and this function may be removed from future versions of the VIX API.
This operation only works on a virtual machine that is replaying.
This function will cause the virtual machine to "go live"; it will resume normal execution, continuing on from the last state that was replayed from the recording.
This function is not supported when using the VIX_SERVICEPROVIDER_VMWARE_PLAYER host type.

Side Effects

None.

Requirements

use VMware::Vix::Simple;
use VMware::Vix::API::Constants;

since VMware Workstation 6.5

Example


my $err;
my $snapshotHandle;
my $vmHandle;

# find the appropriate snapshot handle to replay

# start the replay
$err = VMBeginReplay($vmHandle, $snapshotHandle, 0, VIX_INVALID_HANDLE);
die "VMBeginReplay() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

# wait for some activity to happen, then stop replaying
$err = VMEndReplay($vmHandle, 0, VIX_INVALID_HANDLE);
die "VMEndReplay() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;