DsReplicaConsistencyCheck 函数 (ntdsapi.h)

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

包含一组修改函数行为的标志。这可以是零，也可以是以下一个或多个值的组合。

任务已排队，然后函数返回，而不等待任务完成。

如果另一个排队任务即将运行，则不会将该任务添加到队列中。

如果函数成功执行其操作，则返回值 ERROR_SUCCESS。如果函数失败，则返回值可以是下列值之一。