Función DsReplicaAddA (ntdsapi.h)

Artículo
03/08/2023

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 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, creado o no, o bien como 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 del 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 Options 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 por 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 puede ser 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 valores siguientes.

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 para que se puedan replicar más adelante.

DS_REPADD_DISABLE_NOTIFICATION

Deshabilita la sincronización basada en notificaciones para el controlador de red desde 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 controlador de red desde este origen.

DS_REPADD_INITIAL

Sincroniza el CONTROLADOR de red de 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, por 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 de 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 se 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 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 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