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.
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.
- 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 2008 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Domain Controller and Replication Management Functions
- DsBind
- DsBindWithCred
- DsBindWithSpn
- DS_KCC_TASKID