Función DsReplicaSyncA (ntdsapi.h)

La función DsReplicaSync sincroniza un contexto de nomenclatura de destino (NC) con uno de sus orígenes.

Sintaxis

NTDSAPI DWORD DsReplicaSyncA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] const UUID *pUuidDsaSrc,
  [in] ULONG      Options
);

Parámetros

[in] hDS

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

[in] NameContext

Puntero a una cadena terminada en null constante que especifica el nombre distintivo del NC de destino.

[in] pUuidDsaSrc

Puntero al UUID de un origen que se replica en el NC de destino.

[in] Options

Pasa datos adicionales usados para procesar la solicitud. Este parámetro puede ser una combinación de los siguientes valores.

DS_REPSYNC_ADD_REFERENCE

Hace que el agente del sistema de directorio de origen (DSA) compruebe que la DSA local está presente en la lista de replicaciones de origen. Si no es así, se agrega el DSA local. Esto garantiza que el origen envíe notificaciones de cambio.

DS_REPSYNC_ALL_SOURCES

Este valor no se admite.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista y Windows Server 2003: Sincroniza desde todos los orígenes.

DS_REPSYNC_ASYNCHRONOUS_OPERATION

Realiza esta operación de forma asincrónica.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista y Windows Server 2003: Requerido al usar DS_REPSYNC_ALL_SOURCES.

DS_REPSYNC_FORCE

Sincroniza incluso si el vínculo está deshabilitado actualmente.

DS_REPSYNC_FULL

Sincroniza a partir del primer número de secuencia de actualización (USN).

DS_REPSYNC_INTERSITE_MESSAGING

Sincroniza con un ISM.

DS_REPSYNC_NO_DISCARD

No descarta esta solicitud de sincronización, aunque esté pendiente una sincronización similar.

DS_REPSYNC_PERIODIC

Indica que esta operación es una solicitud de sincronización periódica programada por el administrador.

DS_REPSYNC_URGENT

Indica que esta operación es una notificación de una actualización marcada como urgente.

DS_REPSYNC_WRITEABLE

La réplica se puede escribir. De lo contrario, es de solo lectura.

Valor devuelto

Si la función realiza su operación correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es uno de los errores estándar de la API de Win32.

Observaciones

El servidor en el que se ejecuta DsReplicaSync se denomina destino. El contexto de nomenclatura de destino se incluye up-to-date con respecto a un sistema de origen, identificado por el UUID del objeto NTDS Settings del sistema de origen. El sistema de destino ya debe estar configurado para que el sistema de origen sea uno de los sistemas desde los que recibe los datos de replicación.

Nota Forzar la sincronización manual puede impedir que el servicio de directorio priorice correctamente las operaciones de replicación. Por ejemplo, la sincronización de un nuevo usuario puede adelantar una sincronización urgente realizada para proporcionar acceso a un usuario bloqueado recientemente o agregar una nueva contraseña de confianza. Si llama a esta API a menudo, puede inundar la red con solicitudes, lo que puede interferir con otras operaciones de replicación. Por este motivo, se recomienda encarecidamente que esta función se use solo para escenarios de uso único en lugar de incorporarla a una aplicación que la usaría de forma periódica.

 

Nota

El encabezado ntdsapi.h define DsReplicaSync como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
servidor mínimo admitido	Windows Server 2008
de la plataforma de destino de	Windows
encabezado de	ntdsapi.h
biblioteca de	Ntdsapi.lib
DLL de	Ntdsapi.dll

Consulte también

controlador de dominio y funciones de administración de replicación

DsReplicaAdd

DsReplicaDel

DsReplicaModify

DsReplicaUpdateRefs