CeGetReplChangeBitsEx (Windows CE 5.0)
This function identifies if an object has changed and which partner has not synchronized the change.
BOOL CeGetReplChangeBitsEx(PCEGUID pguid,CEOID oid,LPDWORD lpbits,DWORDdwFlags);
Parameters
- pguid
[in] Pointer to a CEGUID that identifies a mounted database volume or the internal object store. - oid
[in] Object identifier 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 the possible values.Value Description 0 No additional functionality. 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 CeClearReplChangeBitsEx.
Return Values
Returns TRUE if the function succeeds; otherwise, returns FALSE.
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 will remain in the same state to prevent a loss of synchronization data.
This API is part of the bit-based replication model and is not supported under the counter-based replication model.
Requirements
OS Versions: Windows CE 3.0 and later.
Header: Pwindbas.h.
Link Library: Coredll.lib.
See Also
Bit-Based Replication | CeRegisterReplNotification | CeGetReplChangeMask | CeSetReplChangeMask | CeClearReplChangeBitsEx | CeSetReplChangeBitsEx | CeGetReplOtherBitsEx | CeSetReplOtherBitsEx
Send Feedback on this topic to the authors