DsReplicaDelA-Funktion (ntdsapi.h)
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 |