Função DsReplicaModifyA (ntdsapi.h)
A função DsReplicaModify modifica uma referência de origem de replicação existente para um contexto de nomenclatura de destino.
Sintaxe
NTDSAPI DWORD DsReplicaModifyA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] const UUID *pUuidSourceDsa,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD ReplicaFlags,
[in] DWORD ModifyFields,
[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
Ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica o DN (nome diferenciado) do contexto de nomenclatura de destino (NC).
[in] pUuidSourceDsa
Ponteiro para a UUID do agente do sistema de diretório de origem (DSA). Esse parâmetro poderá ser nulo se ModifyFields não incluir DS_REPMOD_UPDATE_ADDRESS e SourceDsaAddress não estiver NULL.
[in] TransportDn
Reservado para uso futuro. Qualquer valor diferente de NULL resulta no retorno de ERROR_NOT_SUPPORTED.
[in] SourceDsaAddress
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo constante que especifica o endereço específico do transporte da DSA de origem. Esse parâmetro será ignorado se pUuidSourceDsa não estiver NULL e modifyFields não incluir DS_REPMOD_UPDATE_ADDRESS.
[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. Esse parâmetro será necessário se ModifyFields contiver o sinalizador DS_REPMOD_UPDATE_SCHEDULE.
[in] ReplicaFlags
Esse parâmetro é usado para controlar o comportamento de replicação e pode levar os valores a seguir.
DS_REPL_NBR_SYNC_ON_STARTUP
A replicação desse contexto de nomenclatura dessa origem é tentada quando o servidor de destino é inicializado. Normalmente, isso só se aplica a vizinhos intra-site.
DS_REPL_NBR_DO_SCHEDULED_SYNCS
Execute a replicação em um agendamento. Esse sinalizador normalmente é definido, a menos que o agendamento para esse contexto de nomenclatura e a origem seja "nunca", ou seja, o agendamento vazio.
DS_REPL_NBR_TWO_WAY_SYNC
Se definido, indica que, quando a replicação de entrada for concluída, o servidor de destino deverá informar ao servidor de origem para sincronizar na direção inversa. Esse recurso é usado em cenários de discagem em que apenas um dos dois servidores pode iniciar uma conexão discada. Por exemplo, essa opção seria usada em uma sede corporativa e filial, em que a filial se conecta à sede corporativa pela Internet por meio de uma conexão ISP discada.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
Esse vizinho está definido para desabilitar a sincronização baseada em notificação. Em um site, os controladores de domínio sincronizam uns com os outros com base em notificações quando ocorrem alterações. Essa configuração impede que esse vizinho execute uma sincronização disparada por uma notificação. O vizinho ainda fará a sincronização com base em sua agenda ou em resposta à sincronização solicitada manualmente.
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
Esse vizinho está definido para não executar a sincronização com base em sua agenda. A única maneira desse vizinho executar a sincronização é em resposta a notificações de alteração ou à sincronização solicitada manualmente.
DS_REPL_NBR_COMPRESS_CHANGES
As alterações recebidas dessa fonte devem ser compactadas. Isso normalmente é definido se, e somente se, o servidor de origem estiver em um site diferente.
DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
Nenhuma notificações de alteração deve ser recebida dessa origem. Isso normalmente é definido se, e somente se, o servidor de origem estiver em um site diferente.
[in] ModifyFields
Especifica quais campos devem ser modificados. Pelo menos um campo deve ser especificado em ModifyFields. Esse parâmetro pode ser uma combinação dos valores a seguir.
DS_REPMOD_UPDATE_ADDRESS
Atualiza o endereço associado ao servidor referenciado.
DS_REPMOD_UPDATE_FLAGS
Atualiza os sinalizadores associados à réplica.
DS_REPMOD_UPDATE_RESULT
Não usado. No momento, não há suporte para a especificação de atualizações de valores de resultado. Os valores de resultado são padrão para 0.
DS_REPMOD_UPDATE_SCHEDULE
Atualiza a agenda de replicação periódica associada à réplica.
DS_REPMOD_UPDATE_TRANSPORT
Atualiza o transporte associado à réplica.
[in] Options
Passa dados adicionais usados para processar a solicitação. Esse parâmetro pode ser uma combinação dos valores a seguir.
DS_REPMOD_ASYNCHRONOUS_OPERATION
Executa essa operação de forma assíncrona.
DS_REPMOD_WRITEABLE
Indica que a réplica que está sendo modificada pode ser gravada.
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 DsReplicaModify 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