ConvertToReferencePoint method of the Msvm_CollectionSnapshotService class

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

Syntax

uint32 ConvertToReferencePoint(
  [in]      Msvm_SnapshotCollection       REF AffectedSnapshotCollection,
  [in, out] Msvm_ReferencePointCollection REF ResultingReferencePointCollection,
  [out]     CIM_ConcreteJob               REF Job
);

Parameters

AffectedSnapshotCollection [in]

Reference to a Msvm_SnapshotCollection containing the affected virtual system snapshot collection.

ResultingReferencePointCollection [in, out]

Reference to a Msvm_ReferencePointCollection containing the resulting virtual system reference point collection

Job [out]

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

Return value

On success, returns either 0 (Complete) or 4096 (Job Started); otherwise, returns an error.

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_CollectionSnapshotService