Función DsReplicaUpdateRefsA (ntdsapi.h)

Artículo
08/25/2023

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 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 del directorio de destino.

[in] pUuidDsaDest

Puntero a un valor 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.

Comentarios

Si DS_REPUPD_ADD_REFERENCE y 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 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