REPLCHANGEINFO (Windows Embedded CE 6.0)

1/6/2010

This structure is used by the ReplFindNextChange and the ReplGetOidStatus functions to return information about one changed object in the object store or in a database volume.

Syntax

struct REPLCHANGEINFO {
  WORD wVersion;
  WORD wStatus;
  WORD wObjType;
  CEOID oidChanged;
  CEOID oidDbase;
};

Members

• wVersion
  Version of this structure. Set this value to 1.

• wStatus
  Status of the changed object. The following table shows possible values.

  Value	Description
  REPLSTATUS_CONFLICT	The object has changed outside the synchronization period. The change will be reflected after a future checkpoint.
  REPLSTATUS_DELETED	The object was deleted.
  REPLSTATUS_MODIFIED	The object was modified in some way by another thread or application. Modifications include creation, a value change, or re-creation.
  REPLSTATUS_UNCHANGED	The object has not changed since the previous checkpoint.

• wObjType
  Current type of the object. The following table shows possible values.

  Type	Description
  OBJTYPE_DATABASE	The object is a database.
  OBJTYPE_DIRECTORY	The object is a directory.
  OBJTYPE_FILE	The object is a file.
  OBJTYPE_INVALID	The object was deleted and no longer has a type.
  OBJTYPE_RECORD	The object is a database record.

• oidChanged
  Object identifier (OID) of the object that was changed.

• oidDbase
  If the object is a record, the OID of the database. If the object is not a record or has been deleted, this member is set to zero.

Remarks

Changes to items can be any of the following:

• Newly created
• Modified
• Deleted
• Deleted and then recreated

A database record can be recreated in a different database. An object, such as a database, can be deleted, and then recreated as another type of object, such as a file.

The reported type may have changed from the previous time the object was read. A type change reflects the deletion of the first object and the reassignment of the object identifier to a newly created object. Similarly, if the object is a database record, the database that the record is in can have changed. Again, the database change reflects the deletion of the first record and reassignment of the object identifier to a new record in a different database.

REPLSTATUS_CONFLICT indicates that an object was changed outside the client's current synchronization period. Typically, an item with this status is not copied during synchronization. Because each checkpoint expands the range of items to be synchronized, after a future checkpoint the object's status reflects the change that was made to it. Synchronizing an object that has a conflict causes synchronizing it more than once.

Additional information about the changed object can be obtained from the CeOidGetInfoEx2 (CEDB) function. Even if the reported status is not REPLSTATUS_DELETED, calls to CeOidGetInfoEx2** and other functions can fail if the object is deleted by another application between the call to ReplFindNextChange or ReplGetOidStatus and the call to the unsuccessful function.**

Requirements

See Also

Reference

Database Replication Structures
CeOidGetInfoEx2 (CEDB)
GetOIDSearchID
ReplFindNextChange
ReplGetOidStatus
ReplOpenSync