Função DsReplicaUpdateRefsA (ntdsapi.h)

Artigo
02/29/2024

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