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
| Header | pwindbas.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
See Also
Reference
Database Replication Functions
CeRegisterReplNotification
CeGetReplChangeMask
CeSetReplChangeMask
CeClearReplChangeBitsEx
CeSetReplChangeBitsEx
CeGetReplOtherBitsEx
CeSetReplOtherBitsEx