Función DsReplicaUpdateRefsA (ntdsapi.h)
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 |
Consulte también
Funciones de administración de replicación y controlador de dominio
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de