MSFT_Synchronized class

Synchronized status of a storage object and its snapshots, clones, or mirrors.

The following syntax is simplified from MOF code and includes all inherited properties.

Syntax

class MSFT_Synchronized
{
  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;
  UInt16   RecoveryPointObjective[];
};

Members

The MSFT_Synchronized class has these types of members:

Properties

The MSFT_Synchronized class has these properties.

CopyMethodology

Data type: UInt16

Access type: Read-only

Specifies the copy methodology that the copy engine uses to create and/or maintain the target element.

Value Meaning
Not Specified
0
The method of maintaining the copy is not specified.
Other
1
Implementation decides
2
Full Copy
3
A full copy of the source object is (or will be) generated.
Incremental Copy
4
Only changed data from the source element is copied to the target element.
Differential Copy
5
Only the new writes to the source element are copied to the target element.
Copy On Write
6
Affected data is copied on the first write to the source or to the target elements.
Copy On Access
7
Affected data is copied on the first access to the source element.
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 snapshot of the source element first, then uses the snapshot as the source of the copy operation to the target element.
Microsoft Reserved
..
Vendor Specific
0x8000..

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.

Value Meaning
Not Managed
0
Low
1
Copy engine I/O has 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 as host I/O.
Microsoft Reserved
..
Vendor Specific
0x8000..

CopyState

Data type: UInt16

Access type: Read-only

Describes the state of the association with respect to replication activity.

Value Meaning
Initialized
2
The link to enable replication is established, and source and replica elements are associated, but the copy operation has not started.
Unsynchronized
3
Not all the source element data has been copied to the target element.
Synchronized
4
For mirror, snapshot, or clone replication, the target represents a copy of the source.
Broken
5
The relationship is non-functional 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 element was gracefully (or systematically) split from its source element. Consistency is guaranteed.
Inactive
8
The copy operation has stopped. Writes to the source element will not be sent to target element.
Suspended
9
Data flow between the source and target elements has stopped. Writes to the source element are held until the association is resumed.
Failedover
10
Reads and writes to and from the target element have failed. The source element is not reachable.
Prepared
11
Initialization has completed and the copy operation started. However, the data flow has not started.
Aborted
12
The copy operation is aborted with the Abort operation. 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 element 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

Describes the replication policy.

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
..
Vendor Specific
0x8000..

PercentSynced

Data type: UInt16

Access type: Read-only

Specifies the percent of the work completed to reach synchronization. Must be set to NULL if the implementation is not capable of providing this information.

ProgressStatus

Data type: UInt16

Access type: Read-only

Describes the status of the association with respect to replication activity.

Value Meaning
Unknown
0
Completed
2
The request is completed. Copy operation is idle.
Dormant
3
The copy operation is inactive, suspended, or quiesced.
Initializing
4
In the process of establishing the source/replica association. The copy operation has not started.
Preparing
5
Preparation is in progress.
Synchronizing
6
Sync is in progress.
Resyncing
7
Resync is in progress.
Restoring
8
Restore is in progress.
Fracturing
9
Fracture is in progress.
Splitting
10
Split is in progress.
Failing over
11
In the process of switching source and target.
Failing back
12
Undoing the result of failover.
Detaching
13
Detach in progress.
Aborting
14
Abort in progress.
Mixed
15
Applies to groups with element pairs with different statuses. Generally, the individual statuses need to be examined.
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 resynced before further copy operations can be issued.
Requires activate
19
The requested operation has completed. However, the synchronization relationship needs to be activated before further copy operations can be issued.
Pending
20
The flow of data has stopped momentarily due to limited bandwidth or a busy system.
Microsoft Reserved
..
Vendor Specific
0x8000..

RecoveryPointObjective

Data type: UInt16 array

Access type: Read-only

Indicates the maximum interval in which data might be lost. For synchronous copy operations, RecoveryPointObjective is 0. For asynchronous copy operations RecoveryPointObjective represents the interval since the most recent transmission of data to the target element.

ReplicaType

Data type: UInt16

Access type: Read-only

Provides information on how the replica is being maintained.

Value Meaning
Not Specified
0
The method of maintaining the copy is not specified.
Full Copy
2
A full copy of the source object is (or will be) generated.
Before Delta
3
The source object will be maintained as a delta data from the replica.
After Delta
4
The replica will be maintained as delta data from the source object.
Log
5
The replica object is being maintained as a log of changes to the source.
Microsoft Reserved
..
Vendor Specific
0x8000..

RequestedCopyState

Data type: UInt16

Access type: Read-only

An integer enumeration that indicates the last requested or desired state for the association. The actual state of the association is represented by CopyState. Note that when CopyState reaches the requested state, his property will be set to "Not Applicable".

SyncMaintained

Data type: Boolean

Access type: Read-only

Indicates whether synchronization is maintained.

SyncMode

Data type: UInt16

Access type: Read-only

Describes whether the target elements will be updated synchronously or asynchronously. If NULL, the implementation decides the mode.

Unknown (0)

Synchronous (2)

Asynchronous (3)

Microsoft Reserved (..)

Vendor Specific (32768..65535)

SyncState

Data type: UInt16

Access type: Read-only

Describes the state of the association with respect to replication activity.

Value Meaning
Initialized
2
The link to enable replication is established and source/replica elements 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 async or sync replication is currently synchronized. When this value is set, SyncMaintained will be true.
Fracture In Progress
7
An operation to fracture an async or sync 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 Progress
10
Operation is in progress to copy the synced object to the system object.
Idle
11
The normal state for an UnSyncAssoc replica.
Broken
12
The relationship is non-functional due to errors in the source, the target, the path between the two, or space constraints.
Fractured
13
An async or sync replication is fractured.
Frozen
14
All blocks are copied from the 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 for an UnSyncAssoc association.
Microsoft Reserved
..
Vendor Specific
0x8000..

SyncTime

Data type: DateTime

Access type: Read-only

The point in time that the virtual disks were synchronized.

SyncType

Data type: UInt16

Access type: Read-only

Describes the intended outcome of the replication.

Value Meaning
Microsoft Reserved
..
Mirror
6
Create and maintain a copy of the source.
Snapshot
7
Create a point-in-time, virtual copy of the source.
Clone
8
Create a point-in-time, full copy the source.
Microsoft Reserved
..
Vendor Specific
0x8000..

Requirements

Minimum supported client
Windows 10 [desktop apps only]
Minimum supported server
Windows Server 2016 [desktop apps only]
Namespace
Root\Microsoft\Windows\Storage
MOF
Storagewmi.mof