CeGetReplChangeBitsEx (Windows Embedded CE 6.0)

1/6/2010

This function identifies whether an object has changed and which partner has not synchronized the change.

Syntax

BOOL CeGetReplChangeBitsEx(
  PCEGUID pguid,
  CEOID oid,
  LPDWORD lpbits,
  DWORD dwFlags
);

Parameters

• pguid
  [in] Pointer to a CEGUID structure that identifies a mounted database volume or the internal object store.

• oid
  [in] Object identifier (OID) to query.

• lpbits
  [out] Buffer that retrieves the record change bits. The first two bits identify for which partner the record has changed when the bit is set.

• dwFlags
  [in] Operation flags that determine the behavior of the function. The following table shows possible values.

  Value	Description
  REPL_CHANGE_WILLCLEAR	Turns on the tri-state bit of the object. An object must set this bit before you can clear a partner's bit with the CeClearReplChangeBitsEx function.
  Zero	No additional functionality.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

The tri-state bit enables a type of transaction on the object's replication bit. You must first check the state of the dirty bit. Then, after data synchronization, the replication bit clears. If something happens between the time you read the dirty bit and synchronize the data, the dirty bit remains in the same state to prevent a loss of synchronization data.

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

Requirements

See Also

Reference

Database Replication Functions
CeRegisterReplNotification
CeGetReplChangeMask
CeSetReplChangeMask
CeClearReplChangeBitsEx
CeSetReplChangeBitsEx
CeGetReplOtherBitsEx
CeSetReplOtherBitsEx

Concepts

Bit-Based Replication