ReplFindNextChange

9/8/2008

Essa função é usada pelo sincronização os clientes usam para enumerar as alterações feitas por outros aplicativos no objeto armazenar ou volume banco de dados.

Syntax

BOOL ReplFindNextChange(
  HREPL hRepl,
  REPLCHANGEINFO* lpChangeInfo,
  BOOL fRestart
);

Parameters

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

• lpChangeInfo
  [out] Ponteiro para uma estrutura REPLCHANGEINFO que recebe informações sobre um objeto alterado no volume.

• fRestart
  [no] Sinalizador que indica se deseja redefinir a iteração no início das alterações desde a última ponto de verificação.

Return Value

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

Se não mais alterado itens existem, o chamar retorna FALSE, e GetLastError Retorna ERROR_NO_MORE_ITEMS.

Remarks

Sobre a chamar primeiro para esta função depois que a sincronização é aberto ou seguinte que uma ponto de verificação, o estado sincronização recebe uma lista de itens alterados a enumerar. Em cada seguinte chamar para esta função, a posição na lista é incrementado e o próximo item retornado. Você pode redefinir a posição na lista com fRestart. Usando fRestart Redefine a enumeração de itens alterados seguinte à criação sessão sincronização ou desde a última ponto de verificação. Ele não voltar up após uma ponto de verificação anterior. Para renumerar completamente itens o volume, crie uma nova sessão sincronização por chamado ReplOpenSync Sem um estado reserva.

Executar uma ponto de verificação redefine o estado enumeração usado por esta função. Após uma ponto de verificação, essa função retorna as alterações feitas por outros segmentos e aplicativos desde a ponto de verificação anterior. Chamando a função ReplCheckpoint antes de todas as alterações foram enumeradas descarta a lista de alterações ser enumerados por essa função e podem resultar em alguns dados não estão sendo sincronizado.

O estado da enumeração está incluído na informações do estado obtidas a função ReplGetSyncState. Se você transmitir o estado salvo reserva para ReplOpenSync, a enumeração pode continuar sem perda após um chamar para a função ReplCloseSync ReplCloseSync.

Com a exceção de exclusões, essa função NÃO retorna alterações feitas pelo cliente presente para o cliente presente. Due to as incompletas informações armazenadas sobre itens excluídos, essa função pode relatório alguns exclusões para o segmento que executadas-los. Além disso, um cliente pode receber duplicado relatórios de alguns exclusões se um aplicativo exclui e não reutilizar um OID. Gravar clientes para poder relatórios inesperado exclusão não causar problemas.

Essa função retorna apenas itens que foram criados, modificados ou excluídos antes de ponto de verificação última. Itens que foram alterados desde a última ponto de verificação não são relatados até após o próximo ponto de verificação.

Essa função retorna apenas itens que têm um status de REPLSTATUS_MODIFIED ou REPLSTATUS_DELETED. Para obter mais informações sobre esses sinalizadores status, consulte REPLCHANGEINFO.

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
ReplCheckpoint
ReplCloseSync
ReplGetOidStatus
ReplGetSyncState
ReplOpenSync
REPLCHANGEINFO

Concepts

Using Replication to Synchronize Data