ConvertToReferencePoint method of the Msvm_VirtualSystemSnapshotService class

Convert an existing virtual system snapshot to a reference point. The snapshot gets deleted as a side effect. Only recovery snapshots can be converted to reference points.

Syntax

uint32 ConvertToReferencePoint(
  [in]      CIM_VirtualSystemSettingData     REF AffectedSnapshot,
  [in]      string                               ReferencePointSettings,
  [in, out] Msvm_VirtualSystemReferencePoint REF ResultingReferencePoint,
  [out]     CIM_ConcreteJob                  REF Job
);

Parameters

AffectedSnapshot [in]

Reference to the affected virtual system snapshot.

ReferencePointSettings [in]

Parameter settings.

ResultingReferencePoint [in, out]

Resulting virtual system reference point

Job [out]

If the operation is long running, then optionally a job may be returned.

Return value

Returns a 0 on success; otherwise, returns one of the following values:

Completed with No Error (0)

Not Supported (1)

Failed (2)

Timeout (3)

Invalid Parameter (4)

Invalid State (5)

Invalid Type (6)

DMTF Reserved (..)

Method Parameters Checked - Job Started (4096)

Method Reserved (4097..32767)

Vendor Specific (32768..65535)

Requirements

Requirement	Value
Minimum supported client	Windows 10 [desktop apps only]
Minimum supported server	Windows Server 2016
Namespace	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

See also

Msvm_VirtualSystemSnapshotService