ReplChangeSyncSettings

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

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 shows the flags that are accepted.

  Flag	Description
  REPL_SYNC_ALLOWOVERWRITE	Allows this client to overwrite changes made by other applications that it has not yet synchronized.
  0	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 may be NULL if you do not need the previous flag.

Return Values

Returns TRUE if the settings are successfully changed. Returns FALSE if an error occurs. For extended error information, see the GetLastError function.

Remarks

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

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 may change at any time to determine the future write and delete behavior of the client.

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

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Pwindbas.h.
Link Library: Coredll.lib.

See Also

Counter-Based Replication | CeDeleteRecord | CeWriteRecordProps | ReplOpenSync

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.