Função DsReplicaAddA (ntdsapi.h)

Artigo
11/20/2024

A função DsReplicaAdd adiciona uma referência de origem de replicação a um contexto de nomenclatura de destino.

Sintaxe

NTDSAPI DWORD DsReplicaAddA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] LPCSTR          SourceDsaDn,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           Options
);

Parâmetros

[in] hDS

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

[in] NameContext

A cadeia de caracteres terminada em nulo que especifica o DN (nome diferenciado) do contexto de nomenclatura de destino (NC) para o qual adicionar a réplica. O registro NC de destino deve existir localmente como um objeto, instanciado ou não, ou um fantasma de referência, por exemplo, um fantasma com um GUID.

[in] SourceDsaDn

A cadeia de caracteres terminada em nulo que especifica o DN do objeto NTDS-DSA para o agente do sistema de diretório de origem. Esse parâmetro será necessário se Opções incluir DS_REPADD_ASYNCHRONOUS_REPLICA; caso contrário, ele será ignorado.

[in] TransportDn

A cadeia de caracteres terminada em nulo que especifica o DN do objeto interSiteTransport que representa o transporte usado para comunicação com o servidor de origem. Esse parâmetro será necessário se Opções incluir DS_REPADD_INTERSITE_MESSAGING; caso contrário, ele será ignorado.

[in] SourceDsaAddress

A cadeia de caracteres terminada em nulo que especifica o endereço específico do transporte da DSA de origem. Esse servidor de origem é identificado por um nome de cadeia de caracteres, não por sua UUID. Um nome de cadeia de caracteres apropriado para SourceDsaAddress geralmente é um nome DNS baseado em um GUID, em que a parte GUID do nome é o GUID do objeto de NTDS-DSA para o servidor de origem.

[in] pSchedule

Ponteiro para uma estrutura SCHEDULE que contém os dados de agendamento de replicação para a fonte de replicação. Esse parâmetro é opcional e pode ser NULL se não for usado.

[in] Options

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

DS_REPADD_ASYNCHRONOUS_OPERATION

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

DS_REPADD_ASYNCHRONOUS_REPLICA

Não replica a NC. Em vez disso, salve dados de estado suficientes para que possam ser replicados posteriormente.

DS_REPADD_DISABLE_NOTIFICATION

Desabilita a sincronização baseada em notificação para a NC dessa origem. Espera-se que esse seja um estado temporário. Use DS_REPADD_NEVER_NOTIFY para desabilitar permanentemente a sincronização.

DS_REPADD_DISABLE_PERIODIC

Desabilita a sincronização periódica para a NC dessa origem.

DS_REPADD_INITIAL

Sincroniza o NC dessa origem quando a DSA é iniciada.

DS_REPADD_INTERSITE_MESSAGING

Sincroniza da DSA de origem usando o transporte do Serviço de Mensagens Intersite (IMS), por exemplo, por SMTP, em vez de usar o RPC do serviço de diretório nativo.

DS_REPADD_NEVER_NOTIFY

Desabilita as notificações de alteração dessa origem. Quando esse sinalizador é definido, a origem não notifica o destino quando ocorrem alterações. Isso é recomendado para todas as replicações entre sites que podem ocorrer em links WAN.

Espera-se que este seja um estado permanente; use DS_REPADD_DISABLE_NOTIFICATION para desabilitar temporariamente as notificações.

DS_REPADD_PERIODIC

Sincroniza a NC dessa fonte periodicamente, conforme definido em pSchedule.

DS_REPADD_USE_COMPRESSION

Usa compactação ao replicar. Isso salva a largura de banda de rede em detrimento da sobrecarga da CPU nos servidores de origem e de destino.

DS_REPADD_WRITEABLE

Cria uma réplica gravável; caso contrário, a réplica é somente leitura.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes.

Observações

Nota

O cabeçalho ntdsapi.h define DsReplicaAdd 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

DsReplicaDel

DsReplicaModify

DsReplicaSync

DsReplicaUpdateRefs

agendar

Compartilhar via