WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX


namespace Synergex.SynergyDE.Select
public sealed class ChangeTracking

The ChangeTracking class returns snapshot information for a file, enabling you to perform change tracking functions from within your program rather than spawning a ctutl command. See Change tracking for an overview of change tracking.



public ChangeTracking(filename)

Creates the snapshot information object for the specified ISAM file (the ctutl filename) (a) in the Snapshots arrayed field.



protected property ChangeTrackingEnabled

Indicates whether change tracking is enabled. Implements a get method that returns true if the file has change tracking enabled or false if change tracking is not enabled. (boolean)



public ApplySnapshot(), void

Synchronizes the file with the ChangeTracking snapshot.

Any activity that occurs after snapshots are enabled is tracked in a pseudo snapshot. This pseudo snapshot is always the last one in the list, but it isn’t an actual snapshot; it just contains all of the activity since the last snapshot. When the ApplySnapshot() method is invoked, a new snapshot is created that contains the contents of the pseudo snapshot, and a new pseudo snapshot begins tracking any new activity. The Snapshots field contains both SnapshotInfo structure information for each snapshot as well as post‑snapshot information from the pseudo snapshot.

If change tracking is not enabled, an error will occur.


public Refresh(), void

Updates the Snapshots array with the file’s current information.



An arrayed field that will be populated with the SnapshotInfo structure information for each snapshot, as well as information about the activity that occurred after the last snapshot. ([#]SnapshotInfo)

See also