Función DsReplicaDelA (ntdsapi.h)
La función DsReplicaDel quita una referencia de origen de replicación de un contexto de nomenclatura de destino (NC).
Sintaxis
NTDSAPI DWORD DsReplicaDelA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR DsaSrc,
[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 (DN) del NC de destino del que se va a quitar 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] DsaSrc
Puntero a una cadena Unicode terminada en null constante que especifica la dirección específica del transporte del agente del sistema de directorio de origen (DSA). Este servidor de origen se identifica mediante un nombre de cadena, no por su UUID. Un nombre de cadena adecuado para DsaSrc suele ser un nombre DNS basado en un GUID de , donde el GUID de parte del nombre es el guid del objeto nTDSDSA para el servidor de origen.
[in] Options
Pasa datos adicionales usados para procesar la solicitud. Este parámetro puede ser una combinación de los siguientes valores.
DS_REPDEL_ASYNCHRONOUS_OPERATION
Realiza esta operación de forma asincrónica.
DS_REPDEL_IGNORE_ERRORS
Omite cualquier error generado al ponerse en contacto con el origen para indicarle que quite este NC de su lista de servidores a los que replica.
DS_REPDEL_INTERSITE_MESSAGING
Indica que la réplica está basada en correo en lugar de sincronizarse mediante RPC del servicio de directorio nativo.
DS_REPDEL_LOCAL_ONLY
No se comunica con el origen para indicarle que quite este NC de su lista de servidores a los que replica. Si no se establece esta marca y el vínculo se basa en RPC, se contactará con el origen.
DS_REPDEL_NO_SOURCE
Elimina todos los objetos de la NC. Esta opción solo es válida para NCs de solo lectura sin origen.
DS_REPDEL_REF_OK
Permite la eliminación de una réplica de solo lectura incluso si crea otras réplicas de solo lectura.
DS_REPDEL_WRITEABLE
Indica que la réplica eliminada se puede escribir en.
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 es un error estándar de la API win32 o ERROR_INVALID_PARAMETER si un parámetro no es válido.
Observaciones
Nota
El encabezado ntdsapi.h define DsReplicaDel 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