DsReplicaDelA-Funktion (ntdsapi.h)
Die DsReplicaDel-Funktion entfernt einen Replikationsquellenverweis aus einem Zielbenennungskontext (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 entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.
[in] NameContext
Zeigen Sie auf eine konstante null-beendete Zeichenfolge, die den Distinguished Name (DN) des Ziel-NC angibt, aus dem das Replikat entfernt werden soll. Der NC-Zieldatensatz muss lokal als Objekt vorhanden sein, instanziiert oder nicht, oder ein Referenz-Phantom, z. B. ein Phantom mit einer GUID.
[in] DsaSrc
Zeigen Sie auf eine konstante, mit Null beendete Unicode-Zeichenfolge, die die transportspezifische Adresse des Quellverzeichnissystem-Agents (DSA) angibt. Dieser Quellserver wird durch einen Zeichenfolgennamen und nicht durch seine UUID-identifiziert. Ein Zeichenfolgenname, der für DsaSrc geeignet ist, ist in der Regel ein DNS-Name, der auf einer GUID-basiert, wobei die 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. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.
DS_REPDEL_ASYNCHRONOUS_OPERATION
Führt diesen Vorgang asynchron aus.
DS_REPDEL_IGNORE_ERRORS
Ignoriert alle Fehler, die beim Kontaktieren der Quelle generiert wurden, um sie anzuweisen, diese NC aus der Liste der Server zu entfernen, auf die sie repliziert wird.
DS_REPDEL_INTERSITE_MESSAGING
Gibt an, dass das Replikat E-Mail-basiert ist und nicht mit systemeigenem Verzeichnisdienst-RPC synchronisiert wird.
DS_REPDEL_LOCAL_ONLY
Wenden Sie sich nicht an die Quelle, um sie anweisen, diese NC aus der Liste der Server zu entfernen, auf die sie repliziert wird. Wenn dieses Flag nicht festgelegt ist und die Verknüpfung 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 angibt.
DS_REPDEL_WRITEABLE
Weist darauf hin, dass das gelöschte Replikat 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.
Bemerkungen
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | ntdsapi.h |
| Library | Ntdsapi.lib |
| DLL- | Ntdsapi.dll |