ReplGetOidStatus (Windows Embedded CE 6.0)

1/6/2010

This function is used by synchronization clients to determine the status of an object in the object store or database volume.

Syntax

BOOL ReplGetOidStatus(
  HREPL hRepl,
  CEOID oid,
  REPLCHANGEINFO* lpChangeInfo
);

Parameters

• hRepl
  [in] Handle to an open synchronization session, obtained from the ReplOpenSync function.

• oid
  [in] Identifier of the object to examine.

• lpChangeInfo
  [out] Pointer to a REPLCHANGEINFO structure that receives information about one changed object in the volume.

Return Value

TRUE indicates success. FALSE indicates failure. For extended error information, call GetLastError.

Remarks

With the exception of deletions, this function does not return changes made by the present client to the present client. Due to the incomplete information that is stored about deleted items, this function can report some deletions to the thread that performed them. In addition, a client can receive duplicate reports of some deletions if an application deletes and does not reuse an OID. Write clients so that extra deletion reports do not cause problems.

This function returns only items that have been created, modified, or deleted before the last checkpoint. Items that were changed since the last checkpoint are not reported until after the next checkpoint.

This function is part of the counter-based replication model and is not supported under the bit-based replication model.

Requirements

See Also

Reference

Database Replication Functions
ReplCheckpoint
ReplFindNextChange
ReplOpenSync
REPLCHANGEINFO

Concepts

Using Replication to Synchronize Data