Name

GetCurrentSnapshot

Description

HRESULT
GetCurrentSnapshot([out] ISnapshot** snapshot,
                   [out,retval] ULONGLONG* error);

This function returns the handle of the current active snapshot belonging to the virtual machine referenced by the IVM object against which this method is invoked.

Parameters

snapshot: Returns an ISnapshot object that describes the current snapshot.
error: The error code returned by the operations.

Return Value

HRESULT

Remarks

This function returns the handle of the current active snapshot belonging to the virtual machine referenced by vmHandle.
The snapshotHandle returned by this function is reference counted. The calling application is responsible for releasing the handle.

Side Effects

None.

Requirements

VixCOM.h, since VMware Workstation 6.0

Example

Dim err
Dim snapshot

err = vm.GetCurrentSnapshot(snapshot)
If lib.ErrorIndicatesFailure(err) Then
   ' Handle error...
End If

' remove/revert, otherwise use the snapshot