Función DsReplicaModifyA (ntdsapi.h)
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 de 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 ERROR_NOT_SUPPORTED devolver.
[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 se puede 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 replicación y puede tomar los siguientes valores.
DS_REPL_NBR_SYNC_ON_STARTUP
La replicación de este contexto de nomenclatura desde este origen se intenta cuando se arranca el servidor de destino. Normalmente, esto solo se aplica a los vecinos dentro del sitio.
DS_REPL_NBR_DO_SCHEDULED_SYNCS
Realice la replicación según una programación. Normalmente, esta marca se establece a menos que la programación para 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 usa en escenarios de acceso telefónico, donde solo uno de los dos servidores puede iniciar una conexión de acceso telefónico. Por ejemplo, esta opción se usaría en una sede corporativa y una sucursal, donde la sucursal se conecta a la sede corporativa a través de Internet mediante una conexión ISP de acceso telefónico.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
Este vecino se establece para deshabilitar la sincronización basada en notificaciones. Dentro de un sitio, los controladores de dominio se sincronizan entre sí en función de las notificaciones cuando se producen cambios. Esta configuración impide que este vecino realice una sincronización desencadenada por una notificación. El vecino seguirá realizando la sincronización en función de su programación o en respuesta a la sincronización solicitada manualmente.
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
Este vecino está establecido para no realizar 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 se deben recibir notificaciones de cambios de 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 siguientes valores.
DS_REPMOD_UPDATE_ADDRESS
Actualiza la dirección asociada al servidor al que se hace referencia.
DS_REPMOD_UPDATE_FLAGS
Actualiza 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
Actualiza la programación de replicación periódica asociada a la réplica.
DS_REPMOD_UPDATE_TRANSPORT
Actualiza 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 siguientes valores.
DS_REPMOD_ASYNCHRONOUS_OPERATION
Realiza esta operación de forma asincrónica.
DS_REPMOD_WRITEABLE
Indica que la réplica en la que se va a modificar 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.
Observaciones
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 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