Función DsReplicaConsistencyCheck (ntdsapi.h)

Artículo
02/29/2024

La función DsReplicaConsistencyCheck invoca al Comprobador de coherencia de conocimiento (KCC) para comprobar la topología de replicación. El KCC ajusta dinámicamente la topología de replicación de datos de la red cuando se agregan o quitan controladores de dominio de la red, cuando un controlador de dominio no está disponible o cuando se cambian las programaciones de replicación de datos.

Sintaxis

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

Parámetros

[in] hDS

Contiene un identificador de servicio de directorio obtenido de la función DSBind, DSBindWithCred o DsBindWithSpn .

[in] TaskID

Identifica la tarea que debe ejecutar el KCC. DS_KCC_TASKID_UPDATE_TOPOLOGY es el único valor admitido actualmente.

[in] dwFlags

Contiene un conjunto de marcas que modifican el comportamiento de la función. Puede ser cero o una combinación de uno o varios de los valores siguientes.

DS_KCC_FLAG_ASYNC_OP

La tarea se pone en cola y, a continuación, la función vuelve sin esperar a que se complete la tarea.

DS_KCC_FLAG_DAMPED

La tarea no se agregará a la cola si se ejecutará próximamente otra tarea en cola.

Valor devuelto

Si la función realiza su operación correctamente, el valor devuelto se ERROR_SUCCESS. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	ntdsapi.h
Library	Ntdsapi.lib
Archivo DLL	Ntdsapi.dll