ReplOpenSync

9/8/2008

Essa função cria uma nova sessão sincronização ou reinicia um já existente.

Syntax

BOOL ReplOpenSync(
  CEGUID* pguid,
  LPBYTE lpSyncState,
  DWORD dwSize,
  DWORD dwSyncFlags,
  HREPL* phRepl
);

Parameters

• pguid
  [no] Ponteiro para a estrutura CEGUID do volume para sincronizar. Use a macro CREATE_SYSTEMGUID para sincronizar com a armazenar objeto.

• lpSyncState
  [no] Buffer de dados que contém informações do estado de uma sessão anterior sincronização obtida pela função ReplGetSyncState. Para começar uma nova sessão, defina este parâmetro como NULL.

• dwSize
  [no] Tamanho do estado de sincronização reserva, em bytes, obtido pelo ReplGetSyncState função. Para começar uma nova sessão, defina este parâmetro como zero.

• dwSyncFlags
  [no] Configurações para a sessão sincronização. A seguinte tabela tabela mostra os valores possíveis.

  Sinalizador	Descrição
  REPL_SYNC_ALLOWOVERWRITE	Permite que este cliente para substituir as alterações feitas por outros aplicativos que ele não foi ainda sincronizado.
  Zero	Bloqueia esse cliente substituam as alterações feitas por outros aplicativos que ele não foi ainda sincronizado.

• phRepl
  [out] Ponteiro para um HREPL que recebe um identificador para o aberto sessão.

Return Value

TRUE indica sucesso. FALSE indica falha. Para informações de erro estendidas, chamar GetLastError.

Remarks

For All Platforms:

Um segmento cliente só pode ter uma sessão sincronização aberto em um tempo, em um volume simples banco de dados ou em armazenar o objeto. Um cliente sincronização pode ter sessões aberto em múltiplo volumes no mesmo tempo. Para aberto outra sessão sobre o mesmo volume, chamar a função ReplCloseSync para fechar a sessão primeiro. Quaisquer outros segmentos não é possível usar o identificador sessão retornado por essa função.

Sinalizadores de sincronização afetam as modificações feitas pelo segmento de cliente somente. Elas não afetam o comportamento de outros clientes ou aplicativos ou de outros segmentos no processo do segmento de cliente. Você pode alteração a sincronização sinalizadores a qualquer momento para determinar a gravação futura e excluir comportamento do cliente.

Essa função é parte do modelo de replicação Counter-Based e não com suporte em modelo de replicação bit-Based.

For Windows Embedded CE:

Sinalizadores de sincronização afetam o comportamento do CeWriteRecordProps (CEDB) e as funções CeDeleteRecord (CEDB). Essas funções falham com ERROR_ACCESS_DENIED para o cliente sincronização substituam as alterações ela não foi ainda ler bloco.

Requirements

Header	pwindbas.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

Database Replication Functions
CeDeleteRecord (CEDB)
CeWriteRecordProps (CEDB)
ReplChangeSyncSettings
ReplCheckpoint
ReplCloseSync
ReplFindNextChange
ReplGetSyncState

Concepts

Using Replication to Synchronize Data