Função DsReplicaSyncA (ntdsapi.h)

Artigo
11/20/2024

A função DsReplicaSync sincroniza um NC (contexto de nomenclatura de destino) com uma de suas fontes.

Sintaxe

NTDSAPI DWORD DsReplicaSyncA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] const UUID *pUuidDsaSrc,
  [in] ULONG      Options
);

Parâmetros

[in] hDS

Contém um identificador de serviço de diretório obtido da função DSBind ou DSBindWithCred.

[in] NameContext

Ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica o nome diferenciado da NC de destino.

[in] pUuidDsaSrc

Ponteiro para a UUID de uma origem que é replicada para o NC de destino.

[in] Options

Passa dados adicionais usados para processar a solicitação. Esse parâmetro pode ser uma combinação dos valores a seguir.

DS_REPSYNC_ADD_REFERENCE

Faz com que o DSA (agente do sistema de diretório de origem) verifique se a DSA local está presente na lista de replicações de origem. Caso contrário, a DSA local será adicionada. Isso garante que a origem envie notificações de alteração.

DS_REPSYNC_ALL_SOURCES

Não há suporte para esse valor.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista e Windows Server 2003: Sincroniza de todas as fontes.

DS_REPSYNC_ASYNCHRONOUS_OPERATION

Executa essa operação de forma assíncrona.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista e Windows Server 2003: Necessário ao usar DS_REPSYNC_ALL_SOURCES.

DS_REPSYNC_FORCE

Sincroniza mesmo se o link estiver desabilitado no momento.

DS_REPSYNC_FULL

Sincroniza a partir do primeiro USN (Número de Sequência de Atualização).

DS_REPSYNC_INTERSITE_MESSAGING

Sincroniza usando um ISM.

DS_REPSYNC_NO_DISCARD

Não descarta essa solicitação de sincronização, mesmo se uma sincronização semelhante estiver pendente.

DS_REPSYNC_PERIODIC

Indica que essa operação é uma solicitação de sincronização periódica, conforme agendado pelo administrador.

DS_REPSYNC_URGENT

Indica que essa operação é uma notificação de uma atualização marcada como urgente.

DS_REPSYNC_WRITEABLE

A réplica é gravável. Caso contrário, ele será somente leitura.

Valor de retorno

Se a função executar sua operação com êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos erros padrão da API Win32.

Observações

O servidor no qual DsReplicaSync é executado é chamado de destino. O contexto de nomenclatura de destino é trazido up-to-date em relação a um sistema de origem, identificado pela UUID do objeto NTDS Settings do sistema de origem. O sistema de destino já deve estar configurado para que o sistema de origem seja um dos sistemas dos quais ele recebe dados de replicação.

Observação Forçar a sincronização manual pode impedir que o serviço de diretório priorize corretamente as operações de replicação. Por exemplo, sincronizar um novo usuário pode prever uma sincronização urgente executada para fornecer acesso a um usuário bloqueado recentemente ou adicionar uma nova senha de confiança. Se você chamar essa API com frequência, poderá inundar a rede com solicitações, o que pode interferir em outras operações de replicação. Por esse motivo, é altamente recomendável que essa função seja usada apenas para cenários de uso único, em vez de incorporá-la em um aplicativo que a usaria regularmente.

Nota

O cabeçalho ntdsapi.h define DsReplicaSync como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Windows
cabeçalho	ntdsapi.h
biblioteca	Ntdsapi.lib
de DLL	Ntdsapi.dll

Consulte também

Funções de gerenciamento de replicação e controlador de domínio

DsReplicaAdd

DsReplicaDel

DsReplicaModify

DsReplicaUpdateRefs

Compartilhar via