DsReplicaConsistencyCheck function

The DsReplicaConsistencyCheck function invokes the Knowledge Consistency Checker (KCC) to verify the replication topology. The KCC dynamically adjusts the data replication topology of your network when domain controllers are added to or removed from the network, when a domain controller is unavailable, or when the data replication schedules are changed.

Syntax

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

Parameters

hDS

Contains a directory service handle obtained from either the DSBind, DSBindWithCred, or DsBindWithSpn function.

TaskID

Identifies the task that the KCC should execute. DS_KCC_TASKID_UPDATE_TOPOLOGY is the only currently supported value.

dwFlags

Contains a set of flags that modify the function behavior. This can be zero or a combination of one or more of the following values.

DS_KCC_FLAG_ASYNC_OP

The task is queued and then the function returns without waiting for the task to complete.

DS_KCC_FLAG_DAMPED

The task will not be added to the queue if another queued task will run soon.

Return Value

If the function performs its operation successfully, the return value is ERROR_SUCCESS. If the function fails, the return value can be one of the following.

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header ntdsapi.h
Library Ntdsapi.lib
DLL Ntdsapi.dll

See Also

DS_KCC_TASKID

Domain Controller and Replication Management Functions

DsBind

DsBindWithCred

DsBindWithSpn