Share via


ReplChangeSyncSettings (Compact 2013)

3/26/2014

This function changes the synchronization client's settings for its synchronization session.

Syntax

BOOL ReplChangeSyncSettings(
  HREPL hRepl,
  DWORD dwSyncFlags,
  LPDWORD lpdwOldFlags
);

Parameters

  • hRepl
    [in] Handle to an open replication session.
  • dwSyncFlags
    [in] Desired settings for the synchronization session. The following table possible values.

    Flag

    Description

    REPL_SYNC_ALLOWOVERWRITE

    Enables this client to overwrite changes made by other applications that it has not yet synchronized.

    Zero

    Blocks this client from overwriting changes made by other applications that it has not yet synchronized.

  • lpdwOldFlags
    [out] Pointer to a DWORD that receives the previous settings. This parameter can be set to NULL if you do not need the previous flag.

Return Value

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

Remarks

The synchronization settings affect modifications made by the client thread only. They do not affect the behavior of other clients or applications or of other threads within the client thread's process. They can change at any time to determine the future write and delete behavior of the client.

The synchronization flags affect the behavior of the CeWriteRecordProps (CEDB) and the CeDeleteRecord (CEDB) functions. These functions fail with ERROR_ACCESS_DENIED to block the synchronization client from overwriting changes it has not yet read.

Requirements

Header

pwindbas.h

Library

coredll.lib

See Also

Reference

Database Replication Functions
CeDeleteRecord (CEDB)
CeWriteRecordProps (CEDB)
ReplOpenSync