Name
GetNamedSnapshot
Description
HRESULT
GetNamedSnapshot([in] BSTR name,
[out] ISnapshot** snapshot,
[out,retval] ULONGLONG* error);
This
method
returns the handle of the snapshot matching the
given name in the virtual machine referenced by vmHandle.
Parameters
- name
-
Idenitfies a snapshot name.
- snapshot
-
An output parameter that receives an ISnapshot object for the named snapshot.
Return Value
HRESULT
Remarks
- This function returns a handle to the snapshot with the matching name.
Since snapshot names are not unique, the first match is returned.
Side Effects
None.
Requirements
VixCOM.h, since VMware Workstation 6.0
Example
VBScript:
Dim snapshot
Dim err
err = vm.GetNamedSnapshot("snapshot 3", snapshot)
If lib.ErrorIndicatesFailure(err) Then
' Handle the error...
End If
Copyright (C) 2007 VMware, Inc. All rights reserved.