ReplGetSyncState

9/8/2008

Essa função obtém informações do estado para um aberto sessão sincronização. Você pode salvar o informações do estado em armazenamento persistente para continuar a sessão posteriormente.

Syntax

BOOL ReplGetSyncState(
  HREPL hRepl,
  LPBYTE lpSyncState,
  LPDWORD lpdwSize,
  BOOL fFailIfUnchanged
);

Parameters

• hRepl
  [no] Identificador para um aberto sessão sincronização, obtido a função ReplOpenSync.

• lpSyncState
  [out] Ponteiro para uma reserva que recebe o informações do estado desta sessão sincronização.

• lpdwSize
  [out] Ponteiro para um DWORD contendo o tamanho do estado de sincronização reserva, em bytes.

• fFailIfUnchanged
  [no] Sinalizador que determina se deve ser a retornar as informações se o estado não foi alterado desde o último bem-sucedido chamar para essa função.

Return Value

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

Remarks

Você pode posteriormente restaurar o estado da sessão de sincronização obtido essa função, passando a reserva de informações para ReplOpenSync. Esta informações do estado inclui o estado retornado pela função a ReplFindNextChange.

Se a reserva não for grande o suficiente para armazenar o informações do estado para esta sessão sincronização, o valor de retorno está FALSE, e GetLastError retorna ERROR_INSUFFICIENT_BUFFER. O tamanho do buffer necessário é armazenado na DWORD apontada pelo lpdwSize.

Se fFailIfUnchanged é definido como TRUE e o estado não foi alterado desde o último bem-sucedido chamar para esta função, o valor de retorno é FALSE, e GetLastError Retorna ERROR_ALREADY_EXISTS.

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

Requirements

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

See Also

Reference

Database Replication Functions
ReplFindNextChange
ReplCheckpoint
ReplCloseSync
ReplOpenSync

Concepts

Using Replication to Synchronize Data