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
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.
