Función DsReplicaUpdateRefsA (ntdsapi.h)

Artículo
11/20/2024

La función DsReplicaUpdateRefs agrega o quita una referencia de replicación para un destino de un contexto de nomenclatura de origen.

Sintaxis

NTDSAPI DWORD DsReplicaUpdateRefsA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] LPCSTR     DsaDest,
  [in] const UUID *pUuidDsaDest,
  [in] ULONG      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 del contexto de nomenclatura de origen.

[in] DsaDest

Puntero a una cadena terminada en null constante que especifica la dirección específica del transporte del agente del sistema de directorio de destino.

[in] pUuidDsaDest

Puntero a un valor de UUID que contiene el agente del sistema del directorio de destino.

[in] Options

Contiene un conjunto de marcas que proporcionan datos adicionales usados para procesar la solicitud. Puede ser cero o una combinación de uno o varios de los valores siguientes.

DS_REPUPD_ADD_REFERENCE

Se agrega una referencia al destino al servidor de origen.

DS_REPUPD_ASYNCHRONOUS_OPERATION

La operación se realiza de forma asincrónica.

DS_REPUPD_DELETE_REFERENCE

Se quita una referencia al destino del servidor de origen.

DS_REPUPD_WRITEABLE

La referencia a la réplica agregada o eliminada se puede escribir. De lo contrario, es de solo lectura.

Valor devuelto

Si la función se realiza correctamente, se devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes.

Observaciones

Si tanto DS_REPUPD_ADD_REFERENCE como DS_REPUPD_DELETE_REFERENCE se establecen en el parámetro Options, se agrega una referencia al destino si aún no existe en el servidor. Si ya existe una referencia al destino, se actualiza la referencia.

Nota

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