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
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
