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

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

MSFT_VirtualDisk