Função DsReplicaUpdateRefsA (ntdsapi.h)
A função DsReplicaUpdateRefs adiciona ou remove uma referência de replicação para um destino de um contexto de nomenclatura de origem.
Sintaxe
NTDSAPI DWORD DsReplicaUpdateRefsA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR DsaDest,
[in] const UUID *pUuidDsaDest,
[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 do contexto de nomenclatura de origem.
[in] DsaDest
Ponteiro para uma cadeia de caracteres terminada em nulo constante que especifica o endereço específico do transporte do agente do sistema de diretório de destino.
[in] pUuidDsaDest
Ponteiro para um UUID valor que contém o agente do sistema de diretório de destino.
[in] Options
Contém um conjunto de sinalizadores que fornecem dados adicionais usados para processar a solicitação. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.
DS_REPUPD_ADD_REFERENCE
Uma referência ao destino é adicionada ao servidor de origem.
DS_REPUPD_ASYNCHRONOUS_OPERATION
A operação é executada de forma assíncrona.
DS_REPUPD_DELETE_REFERENCE
Uma referência ao destino é removida do servidor de origem.
DS_REPUPD_WRITEABLE
A referência à réplica adicionada ou removida é gravável. Caso contrário, ele será somente leitura.
Valor de retorno
Se a função for bem-sucedida, ERROR_SUCCESS será retornado.
Se a função falhar, o valor retornado poderá ser um dos seguintes.
Observações
Se DS_REPUPD_ADD_REFERENCE e DS_REPUPD_DELETE_REFERENCE estiverem definidos no parâmetro Opções, uma referência ao destino será adicionada se ainda não existir no servidor. Se já existir uma referência ao destino, a referência será atualizada.
Nota
O cabeçalho ntdsapi.h define DsReplicaUpdateRefs 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