Función DsReplicaAddA (ntdsapi.h)
La función DsReplicaAdd agrega una referencia de origen de replicación a un contexto de nomenclatura de destino.
Sintaxis
NTDSAPI DWORD DsReplicaAddA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR SourceDsaDn,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[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
Cadena terminada en NULL que especifica el nombre distintivo (DN) del contexto de nomenclatura de destino (NC) para el que se va a agregar la réplica. El registro NC de destino debe existir localmente como un objeto, crear instancias o no, o un fantasma de referencia, por ejemplo, un fantasma con un GUID.
[in] SourceDsaDn
Cadena terminada en null que especifica el DN del objeto NTDS-DSA para el agente del sistema de directorio de origen. Este parámetro es necesario si Options incluye DS_REPADD_ASYNCHRONOUS_REPLICA; de lo contrario, se omite.
[in] TransportDn
Cadena terminada en NULL que especifica el DN del objeto interSiteTransport que representa el transporte utilizado para la comunicación con el servidor de origen. Este parámetro es necesario si Opciones incluye DS_REPADD_INTERSITE_MESSAGING; de lo contrario, se omite.
[in] SourceDsaAddress
Cadena terminada en NULL que especifica la dirección específica del transporte del DSA de origen. Este servidor de origen se identifica mediante un nombre de cadena, no por su UUID. Un nombre de cadena adecuado para sourceDsaAddress suele ser un nombre DNS basado en un GUID, donde la parte GUID del nombre es el GUID del objeto NTDS-DSA para el servidor de origen.
[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.
[in] Options
Pasa datos adicionales que se usarán para procesar la solicitud. Este parámetro puede ser una combinación de los siguientes valores.
DS_REPADD_ASYNCHRONOUS_OPERATION
Realiza esta operación de forma asincrónica.
DS_REPADD_ASYNCHRONOUS_REPLICA
No replica el NC. En su lugar, guarde suficientes datos de estado de forma que se pueda replicar más adelante.
DS_REPADD_DISABLE_NOTIFICATION
Deshabilita la sincronización basada en notificaciones para el NC de este origen. Se espera que sea un estado temporal. Use DS_REPADD_NEVER_NOTIFY para deshabilitar permanentemente la sincronización.
DS_REPADD_DISABLE_PERIODIC
Deshabilita la sincronización periódica para el NC desde este origen.
DS_REPADD_INITIAL
Sincroniza el NC desde este origen cuando se inicia la DSA.
DS_REPADD_INTERSITE_MESSAGING
Sincroniza desde el DSA de origen mediante el transporte del servicio de mensajería intersitio (IMS), por ejemplo, mediante SMTP, en lugar de usar el servicio de directorio nativo RPC.
DS_REPADD_NEVER_NOTIFY
Deshabilita las notificaciones de cambio de este origen. Cuando se establece esta marca, el origen no notifica al destino cuando se producen cambios. Esto se recomienda para todas las replicaciones entre sitios que pueden producirse a través de vínculos WAN.
Se espera que sea un estado permanente; use DS_REPADD_DISABLE_NOTIFICATION para deshabilitar temporalmente las notificaciones.
DS_REPADD_PERIODIC
Sincroniza el NC desde este origen periódicamente, tal como se define en pSchedule.
DS_REPADD_USE_COMPRESSION
Usa la compresión al replicar. Esto ahorra ancho de banda de red a costa de la sobrecarga de CPU en los servidores de origen y destino.
DS_REPADD_WRITEABLE
Crea una réplica grabable; De lo contrario, la réplica es de solo lectura.
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 DsReplicaAdd 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