Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

MSFT_VirtualDiskToVirtualDisk class

Association between a source VirtualDisk and a target VirtualDisk.

The target virtual disk is a shadow copy, mirror, 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 VirtualDisk;
  MSFT_VirtualDisk REF VirtualDisk;
  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.

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

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

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

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

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

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

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.

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

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

 

VirtualDisk
Data type: MSFT_VirtualDisk
Access type: Read-only
Qualifiers: Key

The source virtual disk.

VirtualDisk
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

 

 

Community Additions

Show:
© 2014 Microsoft