Name

VMEndRecording

Description

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

This function stops recording a virtual machine's activity.

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

This operation only works on a virtual machine that is recording.

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;

($err, $snapshotHandle) = VMBeginRecording($vmHandle, "recording 2",
                                           "description of recording 2",
	                                   0, VIX_INVALID_HANDLE);
die "VMBeginRecording() failed, $err ", GetErrorText($err), "\n" if $err != VIX_OK;

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