DsReplicaDelA-Funktion (ntdsapi.h)

Artikel
02/29/2024

Die DsReplicaDel-Funktion entfernt einen Replikationsquellenverweis aus einem Zielnamenskontext (Destination Naming Context, NC).

Syntax

NTDSAPI DWORD DsReplicaDelA(
  [in] HANDLE hDS,
  [in] LPCSTR NameContext,
  [in] LPCSTR DsaSrc,
  [in] ULONG  Options
);

Parameter

[in] hDS

Enthält ein Verzeichnisdiensthandle, das von der DSBind - oder DSBindWithCred-Funktion abgerufen wurde.

[in] NameContext

Zeiger auf eine konstante NULL-endende Zeichenfolge, die den Distinguished Name (DN) der Ziel-NC angibt, aus der das Replikat entfernt werden soll. Der NC-Zieldatensatz muss lokal als Objekt vorhanden sein, instanziiert oder nicht, oder als Referenz-Phantom, z. B. als Phantom mit einer GUID.

[in] DsaSrc

Zeiger auf eine konstante Unicode-Zeichenfolge mit NULL-Beendigung, die die transportspezifische Adresse des Quellverzeichnissystem-Agents (DSA) angibt. Dieser Quellserver wird durch einen Zeichenfolgennamen und nicht durch seine UUID identifiziert. Ein für DsaSrc geeigneter Zeichenfolgenname ist in der Regel ein DNS-Name, der auf einer GUID basiert, wobei der GUID-Teil des Namens die GUID des nTDSDSA-Objekts für den Quellserver ist.

[in] Options

Übergibt zusätzliche Daten, die zum Verarbeiten der Anforderung verwendet werden. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

DS_REPDEL_ASYNCHRONOUS_OPERATION

Führt diesen Vorgang asynchron aus.

DS_REPDEL_IGNORE_ERRORS

Ignoriert alle Fehler, die durch die Kontaktaufnahme mit der Quelle generiert werden, um sie anzuweisen, diese NC aus der Liste der Server zu entfernen, auf die sie repliziert.

DS_REPDEL_INTERSITE_MESSAGING

Gibt an, dass das Replikat E-Mail-basiert und nicht mithilfe des nativen Verzeichnisdiensts RPC synchronisiert wird.

DS_REPDEL_LOCAL_ONLY

Setzt sich nicht mit der Quelle in Verbindung, um sie anweisen zu lassen, diese NC aus der Liste der Server zu entfernen, auf die sie repliziert. Wenn dieses Flag nicht festgelegt ist und der Link in RPC basiert, wird die Quelle kontaktiert.

DS_REPDEL_NO_SOURCE

Löscht alle Objekte im NC. Diese Option ist nur für schreibgeschützte NCs ohne Quelle gültig.

DS_REPDEL_REF_OK

Ermöglicht das Löschen eines schreibgeschützten Replikats, auch wenn es andere schreibgeschützte Replikate beschreibt.

DS_REPDEL_WRITEABLE

Bedeutet, dass das gelöschte Replikat in geschrieben werden kann.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Standardmäßiger Win32-API-Fehler oder ERROR_INVALID_PARAMETER , wenn ein Parameter ungültig ist.

Hinweise

Hinweis

Der ntdsapi.h-Header definiert DsReplicaDel als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	ntdsapi.h
Bibliothek	Ntdsapi.lib
DLL	Ntdsapi.dll