MSFT_VirtualDiskToVirtualDisk class
Association between a source VirtualDisk and a target VirtualDisk.
The target virtual disk is a mirror, snapshot, or clone of the source virtual disk.
The following syntax is simplified from Managed Object Format (MOF) code.
Syntax
[Association]
class MSFT_VirtualDiskToVirtualDisk
{
MSFT_VirtualDisk REF SourceVirtualDisk;
MSFT_VirtualDisk REF TargetVirtualDisk;
Datetime SyncTime;
Boolean SyncMaintained;
UInt16 CopyState;
UInt16 RequestedCopyState;
UInt16 SyncType;
UInt16 SyncMode;
UInt16 ProgressStatus;
UInt16 PercentSynced;
UInt16 CopyType;
UInt16 ReplicaType;
UInt16 SyncState;
UInt16 CopyPriority;
UInt16 CopyMethodology;
};
Members
The MSFT_VirtualDiskToVirtualDisk class has these types of members:
Properties
The MSFT_VirtualDiskToVirtualDisk class has these properties.
CopyMethodology
Data type: UInt16
Access type: Read-only
Specifies the copy methodology that the copy engine uses to create and maintain the target.
One of the following values.
| Value | Meaning |
|---|---|
| Not Specified 0 | The method of maintaining the copy is not specified. |
| Other 1 | The copy engine uses a vendor-specific copy methodology to create and maintain the target. |
| Implementation decides 2 | The implementation chooses the copy methodology. |
| Full Copy 3 | A full copy of the source is generated. |
| Incremental-Copy 4 | Only changed data from the source is copied to the target. |
| Differential-Copy 5 | Only the new writes to the source are copied to the target. |
| Copy-On-Write 6 | On the first write to the source, the affected data is copied to the target. |
| Copy-On-Access 7 | On the first access to the source, the affected data is copied to the target. |
| Delta-Update 8 | Difference-based replication where, after the initial copy, only updates to the source are copied to the target. |
| Snap-And-Clone 9 | The service creates a shadow copy of the source first, then uses the shadow copy as the source of the copy operation to the target. |
| Microsoft Reserved .. | This value is reserved for system use. |
| Vendor Specific 0x8000.. | These values are reserved for vendors. |
CopyPriority
Data type: UInt16
Access type: Read-only
Allows the priority of background copy engine I/O to be managed relative to host I/O operations during a sequential background copy operation.
One of the following values.
| Value | Meaning |
|---|---|
| Not Managed 0 | The priority of copy engine I/O to host I/O is not managed. |
| Low 1 | Copy engine I/O is lower priority than host I/O. |
| Same 2 | Copy engine I/O has the same priority as host I/O. |
| High 3 | Copy engine I/O has higher priority than host I/O. |
| Microsoft Reserved .. | This value is reserved for system use. |
| Vendor Specific 0x8000.. | These values are reserved for vendors. |
CopyState
Data type: UInt16
Access type: Read-only
The replication state of the association. One of the following values.
| Value | Meaning |
|---|---|
| Initialized 2 | The link to enable replication is established, and the source and target have been associated. However, the copy operation has not started. |
| Unsynchronized 3 | Not all of the source data has been copied to the target. |
| Synchronized 4 | All of the source data has been copied to the target. |
| Broken 5 | The relationship is nonfunctional due to errors in the source, the target, the path between the two, or space constraints. |
| Fractured 6 | The target is split from the source. |
| Split 7 | The target was gracefully (or systematically) split from the source in a way that ensures consistency. |
| Inactive 8 | The copy operation has stopped. Writes to the source will not be sent to the target. |
| Suspended 9 | Data flow between the source and target has stopped. Writes to the source are held until the association is resumed. |
| Failedover 10 | Reads from and writes to the target have failed. The source is not reachable. |
| Prepared 11 | Initialization is completed, and the copy operation has started. However, the data flow has not started. |
| Aborted 12 | The copy operation was aborted. Use the Resync Replica operation to restart the copy operation. |
| Skewed 13 | The target has been modified and is no longer synchronized with the source or the point-in-time view. |
| Mixed 14 | Applies to the CopyState of GroupSynchronized. It indicates that the StorageSynchronized associations of the elements in the groups have different CopyState values. |
| Not Applicable 15 | The target does not have a replication state. |
| Microsoft Reserved .. | This value is reserved for system use. |
| Vendor Specific 0x8000.. | These values are reserved for vendors. |
CopyType
Data type: UInt16
Access type: Read-only
The replication policy for the association.
One of the following values.
| Value | Meaning |
|---|---|
| Async 2 | Create and maintain an asynchronous copy of the source. |
| Sync 3 | Create and maintain a synchronized copy of the source. |
| UnSyncAssoc 4 | Create an unsynchronized copy and maintain an association to the source. |
| UnSyncUnAssoc 5 | Create an unsynchronized copy with a temporary association that is deleted upon completion of the copy operation. |
| Microsoft Reserved .. | This value is reserved for system use. |
| Vendor Specific 0x8000.. | These values are reserved for vendors. |
PercentSynced
Data type: UInt16
Access type: Read-only
The percentage of the work completed to reach synchronization. Must be set to NULL if implementation is not capable of providing this information.
ProgressStatus
Data type: UInt16
Access type: Read-only
The status of the association with respect to replication activity.
One of the following values.
| Value | Meaning |
|---|---|
| Unknown 0 | The status of the association is unknown. |
| Completed 2 | The request has been completed. The copy operation is idle. |
| Dormant 3 | The copy operation is inactive, suspended, or quiesced. |
| Initializing 4 | The source-to-target association is in the process of being initialized, and the copy operation has not started. |
| Preparing 5 | The copy operation is in the process of being prepared. |
| Synchronizing 6 | The source and target are in the process of being synchronized. |
| Resyncing 7 | The source and target are in the process of being resynchronized. |
| Restoring 8 | The source is in the process of being restored from the target. |
| Fracturing 9 | A fracture is in progress. |
| Splitting 10 | A split is in progress. |
| Failing over 11 | A failover is in progress. This means that the source and target are being switched. |
| Failing back 12 | The result of failover is being undone. |
| Aborting 13 | The operation is in the process of being aborted. |
| Mixed 14 | This value applies to groups with element pairs with different statuses. Generally, the individual statuses need to examined. |
| Not Applicable 15 | The target does not have a progress status. |
| Suspending 16 | The copy operation is in the process of being suspended. |
| Requires fracture 17 | The requested operation has completed. However, the synchronization relationship needs to be fractured before further copy operations can be issued. |
| Requires resync 18 | The requested operation has completed, however, the synchronization relationship needs to be resynchronized before further copy operations can be started. |
| Requires activate 19 | The requested operation has completed, however, the synchronization relationship needs to be activated before further copy operations can be started. |
| Pending 20 | The flow of data has stopped momentarily due to limited bandwidth or busy system. |
| Detaching 21 | The target is being detached from the source. |
| Microsoft Reserved .. | This value is reserved for system use. |
| Vendor Specific 0x8000.. | These values are reserved for vendors. |
ReplicaType
Data type: UInt16
Access type: Read-only
Provides information on how the replica is being maintained.
One of the following values.
| Value | Meaning |
|---|---|
| Not Specified 0 | The method of maintaining the copy is not specified. |
| Full Copy 2 | A full copy of the source will be created. |
| Before Delta 3 | The source will be maintained as delta data from the target. |
| After Delta 4 | The target will be maintained as delta data from the source. |
| Log 5 | The target is being maintained as a log of changes to the source. |
| Microsoft Reserved .. | This value is reserved for system use. |
| Vendor Specific 0x8000.. | These value are reserved for vendors. |
RequestedCopyState
Data type: UInt16
Access type: Read-only
The last requested or desired state for the association. The actual state of the association is represented by the CopyState property. Note that when CopyState reaches the requested state, this property will be set to Not Applicable.
The default value of this property is Not Applicable.
SourceVirtualDisk
Data type: MSFT_VirtualDisk
Access type: Read-only
Qualifiers: Key
The source virtual disk.
SyncMaintained
Data type: Boolean
Access type: Read-only
TRUE if synchronization is maintained.
SyncMode
Data type: UInt16
Access type: Read-only
Describes whether the target will be updated synchronously or asynchronously. If NULL, the implementation chooses the mode.
One of the following values.
Unknown (0)
Synchronous (2)
Asynchronous (3)
Microsoft Reserved (..)
Vendor Specific (32768..65535)
SyncState
Data type: UInt16
Access type: Read-only
The state of the association with respect to replication activity.
One of the following values.
| Value | Meaning |
|---|---|
| Initialized 2 | The link to enable replication is established, and the source and target are associated, but the copy engine has not started. |
| PrepareInProgress 3 | Preparation for replication is in progress and the copy engine has started. |
| Prepared 4 | All necessary preparation has completed. |
| ResyncInProgress 5 | Synchronization or resynchronization is in progress. This may be the initial copy or subsequent changes being copied. |
| Synchronized 6 | An asynchronous or synchronous replication is currently synchronized. When this value is set, the SyncMaintained property will be TRUE. |
| Fracture In Progress 7 | An operation to fracture an asynchronous or synchronous replication is in progress. |
| QuiesceInProgress 8 | A quiesce operation is in progress. |
| Quiesced 9 | The replication has been quiesced and is ready for a change. |
| Restore In Progresss 10 | An operation is in progress to copy the synchronized object to the System object. |
| Idle 11 | The normal state for the replica if the CopyType property is UnSyncAssoc. |
| Broken 12 | The relationship is nonfunctional due to errors in the source, the target, the path between the two or space constraints. |
| Fractured 13 | The replication is fractured. |
| Frozen 14 | All blocks copied from source to an UnSyncAssoc replica and the copy engine is stopped. |
| Copy In Progress 15 | A deferred background copy operation is in progress to copy the source to the replica target. This will only occur if the CopyType property is UnSyncAssoc. |
| Microsoft Reserved .. | This value is reserved for system use. |
| Vendor Specific 0x8000.. | These values are reserved for vendors. |
SyncTime
Data type: Datetime
Access type: Read-only
The last time when the source and target virtual disks were synchronized.
SyncType
Data type: UInt16
Access type: Read-only
The intended outcome of the replication. One of the following values.
| Value | Meaning |
|---|---|
| Microsoft Reserved .. | This value is reserved for system use. |
| Mirror 6 | Create and maintain a copy of the source. |
| Snapshot 7 | Create a volume shadow copy of the source. |
| Clone 8 | Create a point-in-time, full copy of the source. |
| Microsoft Reserved .. | This value is reserved for system use. |
| Vendor Specific 0x8000.. | These values are reserved for vendors. |
TargetVirtualDisk
Data type: MSFT_VirtualDisk
Access type: Read-only
Qualifiers: Key
The target virtual disk.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for