Función DsReplicaDelA (ntdsapi.h)

Artículo
03/08/2023

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 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, creado o no, o bien como 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 del directorio de origen (DSA). Este servidor de origen se identifica por un nombre de cadena, no por su UUID. Un nombre de cadena adecuado para DsaSrc suele ser un nombre DNS basado en un GUID, donde la parte GUID 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 valores siguientes.

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 en los que se replica.

DS_REPDEL_INTERSITE_MESSAGING

Indica que la réplica se basa 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 del NC. Esta opción solo es válida para NCs de solo lectura sin ningún 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 se ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un error estándar de la API de Win32 o ERROR_INVALID_PARAMETER si un parámetro no es válido.

Comentarios

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 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