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 valor UUID 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 é somente leitura.
Retornar valor
Se a função for bem-sucedida, ERROR_SUCCESS será retornado.
Se a função falhar, o valor retornado poderá ser um dos seguintes.
Comentários
Se DS_REPUPD_ADD_REFERENCE e DS_REPUPD_DELETE_REFERENCE estiverem definidos no parâmetro Options , 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.
Observação
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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista |
Servidor mínimo com suporte | Windows Server 2008 |
Plataforma de Destino | Windows |
Cabeçalho | ntdsapi.h |
Biblioteca | Ntdsapi.lib |
DLL | Ntdsapi.dll |
Confira também
Funções de gerenciamento de replicação e controlador de domínio