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


DWORD WINAPI DsReplicaConsistencyCheck(
  _In_  HANDLE hDS,
  _In_  DS_KCC_TASKID TaskID,
  _In_  DWORD dwFlags
);

Parameters

hDS [in]

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

TaskID [in]

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

dwFlags [in]

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.

ValueMeaning
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.

Return codeDescription
ERROR_INVALID_PARAMETER

One, of the specified parameters, is invalid.

ERROR_NOT_SUPPORTED

The requested version of the directory service server extensions is not supported.

ERROR_DS_DRA_ACCESS_DENIED

The user associated with the credentials tied to hDS does not have sufficient privileges to read the requested replication state data. The user must have the "Manage Replication Topology" control access right on the root of the configuration naming context.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Ntdsapi.h

Library

Ntdsapi.lib

DLL

Ntdsapi.dll

See also

Domain Controller and Replication Management Functions
DsBind
DsBindWithCred
DsBindWithSpn

 

 

Show:
© 2014 Microsoft