Edit

CreateReferencePoint method of the Msvm_VirtualSystemReferencePointService class

  • Article

Creates a reference point of a virtual system.

Syntax

uint32 CreateReferencePoint(
  [in]      Msvm_ComputerSystem              REF AffectedSystem,
  [in]      string                               ReferencePointSettings,
  [in]      uint16                               ReferencePointType,
  [in, out] Msvm_VirtualSystemReferencePoint REF ResultingReferencePoint,
  [out]     CIM_ConcreteJob                  REF Job
);

Parameters

AffectedSystem [in]

A Msvm_ComputerSystem that references the affected virtual system.

ReferencePointSettings [in]

Contains the parameter settings.

ReferencePointType [in]

Requested reference point type:

Log based (0)

Based on Hyper-V replica log tracking.

RCT based (1)

Based on Resilient Change Tracking of virtual disks.

ResultingReferencePoint [in, out]

Resulting virtual system reference point

Job [out]

If the operation is long running, then optionally a job may be returned. In this case, the instance of the Msvm_VirtualSystemReferencePoint class representing the new virtual system reference point is presented via the CIM_AffectedJobElement association with the value of the AffectedElement property referring to the new instance of the Msvm_VirtualSystemReferencePoint class representing the virtual system reference point and the value of the ElementEffects set to 5 (Create).

Return value

On success, returns 0; 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_VirtualSystemReferencePointService