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
| Requirement | Value |
|---|---|
| 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 |