Función DsReplicaSyncAllA (ntdsapi.h)

Artículo
08/25/2023

La función DsReplicaSyncAll sincroniza un servidor con todos los demás servidores, mediante la replicación transitiva, según sea necesario. De forma predeterminada, DsReplicaSyncAll sincroniza el servidor con todos los demás servidores de su sitio; sin embargo, también puede usarlo para sincronizarse a través de los límites del sitio.

Sintaxis

NTDSAPI DWORD DsReplicaSyncAllA(
  [in]            HANDLE                                  hDS,
  [in]            LPCSTR                                  pszNameContext,
  [in]            ULONG                                   ulFlags,
  [in]            BOOL(* )(LPVOID,PDS_REPSYNCALL_UPDATEA) pFnCallBack,
  [in, optional]  LPVOID                                  pCallbackData,
  [out, optional] PDS_REPSYNCALL_ERRINFOA                 **pErrors
);

Parámetros

[in] hDS

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

[in] pszNameContext

Puntero a una cadena terminada en null que especifica el nombre distintivo del contexto de nomenclatura que se va a sincronizar. El parámetro pszNameContext es opcional; si su valor es NULL, se replica el contexto de nomenclatura de configuración.

[in] ulFlags

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

DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE

Genera un error irrecuperable si no se puede ponerse en contacto con cualquier servidor o si algún servidor no es accesible debido a una topología desconectada o interrumpida.

DS_REPSYNCALL_CROSS_SITE_BOUNDARIES

Realiza la sincronización traspasando los límites del sitio. De forma predeterminada, DsReplicaSyncAll intenta sincronizarse solo con controladores de dominio en el mismo sitio que el sistema principal. Establezca esta marca para intentar sincronizar con todos los controladores de dominio del bosque de empresa. Sin embargo, los controladores de dominio solo se pueden sincronizar si están conectados mediante un transporte sincrónico (RPC).

DS_REPSYNCALL_DO_NOT_SYNC

Deshabilita toda la sincronización. La topología todavía se analiza y todavía se identifican los servidores no accesibles o no disponibles.

DS_REPSYNCALL_ID_SERVERS_BY_DN

En caso de un error irrecuperable, devuelve nombres distintivos de servidor (DN) en lugar de sus nombres DNS GUID.

DS_REPSYNCALL_NO_OPTIONS

Esta opción no tiene ningún efecto.

DS_REPSYNCALL_PUSH_CHANGES_OUTWARD

Inserta los cambios del servidor principal en todos los servidores asociados por medio de la replicación transitiva. Esto invierte la dirección de la replicación y el orden de ejecución de los conjuntos de replicación del modo habitual de ejecución "extracción".

DS_REPSYNCALL_SKIP_INITIAL_CHECK

Se da por supuesto que todos los servidores responden. Esto acelera el funcionamiento de la función DsReplicaSyncAll , pero si algunos servidores no responden, es posible que se bloqueen algunas replicaciones transitivas.

DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY

Deshabilita la replicación transitiva. La sincronización sólo se realiza con los servidores adyacentes.

[in] pFnCallBack

Puntero a una función SyncUpdateProc definida por la aplicación llamada por la función DsReplicaSyncAll cuando encuentra un error, inicia la sincronización de dos servidores, completa la sincronización de dos servidores o finaliza la sincronización de todos los servidores del sitio.

[in, optional] pCallbackData

Puntero a los datos definidos por la aplicación pasados como primer argumento de la función de devolución de llamada SyncUpdateProc a la que apunta el parámetro pFnCallBack .

[out, optional] pErrors

Matriz terminada en NULL de punteros a
DS_REPSYNCALL_ERRINFO estructuras que contienen errores que se produjeron durante la sincronización. La memoria utilizada para contener tanto la matriz de punteros como los datos de MsCS\mscs\clusctl_resource_type_get_private_property_fmts.xml se asignan como un único bloque de memoria y deben liberarse cuando ya no sea necesaria por una sola llamada a LocalFree con el valor de puntero devuelto en pErrors usado como argumento.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es el siguiente.

Comentarios

La función DsReplicaSyncAll intenta enlazar a todos los servidores antes de generar una topología desde la que se va a sincronizar. Si no se puede ponerse en contacto con un servidor, la función excluye ese servidor de la topología e intenta solucionarlo. Al establecer la marca de DS_REPSYNCALL_SKIP_INITIAL_CHECK en ulFlags , se omite el enlace inicial.

Si no se puede establecer contacto con un servidor, la función DsReplicaSyncAll intenta enrutarlo y replicar desde tantos servidores como sea posible, a menos que DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE esté establecido en ulFlags.

La función DsReplicaSyncAll puede usar la función de devolución de llamada a la que apunta pFnCallBack para mantener al usuario final informado sobre el estado actual de la replicación. La ejecución de la función DsReplicaSyncAll se detiene cuando llama a la función a la que apunta pFnCallBack. Si el valor devuelto de la función de devolución de llamada es TRUE, la replicación continúa; de lo contrario, la función DsReplicaSyncAll finaliza la replicación.

Nota

El encabezado ntdsapi.h define DsReplicaSyncAll 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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