Função DsReplicaConsistencyCheck (ntdsapi.h)

Artigo
03/13/2024

A função DsReplicaConsistencyCheck invoca o KCC (Verificador de Consistência de Conhecimento) para verificar a topologia de replicação. O KCC ajusta dinamicamente a topologia de replicação de dados da rede quando os controladores de domínio são adicionados ou removidos da rede, quando um controlador de domínio não está disponível ou quando os agendamentos de replicação de dados são alterados.

Sintaxe

NTDSAPI DWORD DsReplicaConsistencyCheck(
  [in] HANDLE        hDS,
  [in] DS_KCC_TASKID TaskID,
  [in] DWORD         dwFlags
);

Parâmetros

[in] hDS

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

[in] TaskID

Identifica a tarefa que o KCC deve executar. DS_KCC_TASKID_UPDATE_TOPOLOGY é o único valor com suporte no momento.

[in] dwFlags

Contém um conjunto de sinalizadores que modificam o comportamento da função. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.

DS_KCC_FLAG_ASYNC_OP

A tarefa é enfileirada e, em seguida, a função retorna sem aguardar a conclusão da tarefa.

DS_KCC_FLAG_DAMPED

A tarefa não será adicionada à fila se outra tarefa enfileirada for executada em breve.

Retornar valor

Se a função executar sua operação com êxito, o valor retornado será ERROR_SUCCESS. Se a função falhar, o valor retornado poderá ser um dos seguintes.

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