Функция DsReplicaConsistencyCheck (ntdsapi.h)

Статья
03/05/2024

Функция DsReplicaConsistencyCheck вызывает средство проверки согласованности знаний (KCC) для проверки топологии репликации. KCC динамически настраивает топологию репликации данных в сети при добавлении контроллеров домена или удалении из нее, при недоступности контроллера домена или изменении расписаний репликации данных.

Синтаксис

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

Параметры

[in] hDS

Содержит дескриптор службы каталогов, полученный из функции DSBind, DSBindWithCred или DsBindWithSpn .

[in] TaskID

Определяет задачу, которую должен выполнить KCC. DS_KCC_TASKID_UPDATE_TOPOLOGY является единственным поддерживаемым значением.

[in] dwFlags

Содержит набор флагов, которые изменяют поведение функции. Это может быть ноль или сочетание одного или нескольких из следующих значений.

DS_KCC_FLAG_ASYNC_OP

Задача помещается в очередь, а затем функция возвращается, не дожидаясь завершения задачи.

DS_KCC_FLAG_DAMPED

Задача не будет добавлена в очередь, если в ближайшее время будет запущена другая поставленная в очередь задача.

Возвращаемое значение

Если функция успешно выполняет свою операцию, возвращаемое значение будет ERROR_SUCCESS. Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	ntdsapi.h
Библиотека	Ntdsapi.lib
DLL	Ntdsapi.dll