Función DsReplicaModifyA (ntdsapi.h)

Artículo
02/29/2024

La función DsReplicaModify modifica una referencia de origen de replicación existente para un contexto de nomenclatura de destino.

Sintaxis

NTDSAPI DWORD DsReplicaModifyA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] const UUID      *pUuidSourceDsa,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           ReplicaFlags,
  [in] DWORD           ModifyFields,
  [in] DWORD           Options
);

Parámetros

[in] hDS

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

[in] NameContext

Puntero a una cadena terminada en null constante que especifica el nombre distintivo (DN) del contexto de nomenclatura de destino (NC).

[in] pUuidSourceDsa

Puntero al UUID del agente del sistema de directorio de origen (DSA). Este parámetro puede ser null si ModifyFields no incluye DS_REPMOD_UPDATE_ADDRESS y SourceDsaAddress no es NULL.

[in] TransportDn

Reservado para uso futuro. Cualquier valor distinto de NULL da como resultado que se devuelva ERROR_NOT_SUPPORTED .

[in] SourceDsaAddress

Puntero a una cadena Unicode terminada en null constante que especifica la dirección específica del transporte del DSA de origen. Este parámetro se omite si pUuidSourceDsa no es NULL y ModifyFields no incluye DS_REPMOD_UPDATE_ADDRESS.

[in] pSchedule

Puntero a una estructura SCHEDULE que contiene los datos de programación de replicación para el origen de replicación. Este parámetro es opcional y puede ser NULL si no se usa. Este parámetro es necesario si ModifyFields contiene la marca DS_REPMOD_UPDATE_SCHEDULE .

[in] ReplicaFlags

Este parámetro se usa para controlar el comportamiento de la replicación y puede tomar los siguientes valores.

DS_REPL_NBR_SYNC_ON_STARTUP

La replicación de este contexto de nomenclatura de este origen se intenta cuando se arranca el servidor de destino. Normalmente sólo se aplica a vecinos de un mismo sitio.

DS_REPL_NBR_DO_SCHEDULED_SYNCS

La replicación se realiza según una programación. Normalmente, esta marca se establece a menos que la programación de este contexto de nomenclatura y el origen sea "nunca", es decir, la programación vacía.

DS_REPL_NBR_TWO_WAY_SYNC

Si se establece, indica que una vez completada la replicación entrante, el servidor de destino debe indicar al servidor de origen que se sincronice en la dirección inversa. Esta característica se utiliza en escenarios de acceso telefónico en los que sólo uno de los dos servidores puede iniciar una conexión de acceso telefónico. Por ejemplo, esta opción se utilizaría entre la oficina central de una empresa y una sucursal cuando la segunda se conecta a la primera a través de Internet por medio de una conexión de ISP de acceso telefónico.

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS

Este vecino está establecido para deshabilitar la sincronización basada en notificaciones. Dentro de un sitio, los controladores de dominio se sincronizan entre sí basándose en las notificaciones de cambios. Esta configuración impide que este vecino realice una sincronización desencadenada por una notificación. El vecino seguirá sincronizando según su programación o en respuesta a la sincronización solicitada manualmente.

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC

Este vecino está establecido para que no realice la sincronización en función de su programación. La única manera en que este vecino realizará la sincronización es en respuesta a las notificaciones de cambio o a la sincronización solicitada manualmente.

DS_REPL_NBR_COMPRESS_CHANGES

Los cambios recibidos de este origen se van a comprimir. Normalmente, esto se establece si, y solo si, el servidor de origen está en un sitio diferente.

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

No deberían recibirse notificaciones de cambios desde este origen. Normalmente, esto se establece si, y solo si, el servidor de origen está en un sitio diferente.

[in] ModifyFields

Especifica qué campos se deben modificar. Debe especificarse al menos un campo en ModifyFields. Este parámetro puede ser una combinación de los valores siguientes.

DS_REPMOD_UPDATE_ADDRESS

Novedades la dirección asociada al servidor al que se hace referencia.

DS_REPMOD_UPDATE_FLAGS

Novedades las marcas asociadas a la réplica.

DS_REPMOD_UPDATE_RESULT

No se usa. Actualmente no se admite la especificación de actualizaciones de valores de resultado. Los valores de resultado predeterminados son 0.

DS_REPMOD_UPDATE_SCHEDULE

Novedades la programación de replicación periódica asociada a la réplica.

DS_REPMOD_UPDATE_TRANSPORT

Novedades el transporte asociado a la réplica.

[in] Options

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

DS_REPMOD_ASYNCHRONOUS_OPERATION

Realiza esta operación de forma asincrónica.

DS_REPMOD_WRITEABLE

Indica que la réplica en la que se está modificando se puede escribir.

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 puede ser uno de los siguientes.

Comentarios

Nota

El encabezado ntdsapi.h define DsReplicaModify 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