DsReplicaModifyA-Funktion (ntdsapi.h)

Artikel
08/25/2023

Die DsReplicaModify-Funktion ändert einen vorhandenen Replikationsquellenverweis für einen Zielnamenskontext.

Syntax

NTDSAPI DWORD DsReplicaModifyA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] const UUID      *pUuidSourceDsa,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           ReplicaFlags,
  [in] DWORD           ModifyFields,
  [in] DWORD           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) des Zielnamenskontexts (Destination Naming Context, NC) angibt.

[in] pUuidSourceDsa

Zeiger auf die UUID des Quellverzeichnissystem-Agents (DSA). Dieser Parameter kann NULL sein, wenn ModifyFields nicht DS_REPMOD_UPDATE_ADDRESS und SourceDsaAddress nicht NULL ist.

[in] TransportDn

Für die zukünftige Verwendung reserviert. Jeder andere Wert als NULL führt dazu , dass ERROR_NOT_SUPPORTED zurückgegeben wird.

[in] SourceDsaAddress

Zeiger auf eine konstante Unicode-Zeichenfolge mit Null-Ende, die die transportspezifische Adresse des Quell-DSA angibt. Dieser Parameter wird ignoriert, wenn pUuidSourceDsa nicht NULL ist und ModifyFields keine DS_REPMOD_UPDATE_ADDRESS enthält.

[in] pSchedule

Zeiger auf eine SCHEDULE-Struktur , die die Replikationszeitplandaten für die Replikationsquelle enthält. Dieser Parameter ist optional und kann NULL sein, wenn er nicht verwendet wird. Dieser Parameter ist erforderlich, wenn ModifyFields das flag DS_REPMOD_UPDATE_SCHEDULE enthält.

[in] ReplicaFlags

Dieser Parameter wird verwendet, um das Replikationsverhalten zu steuern und kann die folgenden Werte annehmen.

DS_REPL_NBR_SYNC_ON_STARTUP

Die Replikation dieses Namenskontexts aus dieser Quelle wird versucht, wenn der Zielserver gestartet wird. Dies gilt normalerweise nur für standortübergreifende Nachbarn.

DS_REPL_NBR_DO_SCHEDULED_SYNCS

Die Replikation nach einem Zeitplan ausführen. Dieses Flag wird normalerweise festgelegt, es sei denn, der Zeitplan für diesen Namenskontext und die Quelle lautet "never", d. h. der leere Zeitplan.

DS_REPL_NBR_TWO_WAY_SYNC

Wenn festgelegt, gibt an, dass der Zielserver nach Abschluss der eingehenden Replikation den Quellserver anweisen muss, in umgekehrter Richtung zu synchronisieren. Dieses Feature wird in DFÜ-Szenarien verwendet, in denen nur einer der beiden Server eine DFÜ-Verbindung initiieren kann. Diese Option würde z. B. in einer Konzernzentrale und einer Zweigstelle verwendet werden, wenn die Zweigstelle über eine DFÜ-ISP-Verbindung eine Verbindung mit der Konzernzentrale herstellt.

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS

Dieser Nachbar ist so festgelegt, dass die benachrichtigungsbasierte Synchronisierung deaktiviert wird. Innerhalb eines Standorts werden Domänencontroller bei Vornahme von Änderungen auf Grundlage von Benachrichtigungen miteinander synchronisiert. Diese Einstellung verhindert, dass dieser Nachbar eine durch eine Benachrichtigung ausgelöste Synchronisierung ausführt. Der Nachbar führt die Synchronisierung weiterhin basierend auf seinem Zeitplan oder als Reaktion auf die manuell angeforderte Synchronisierung durch.

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC

Dieser Nachbar ist so festgelegt, dass keine Synchronisierung basierend auf seinem Zeitplan ausgeführt wird. Die einzige Möglichkeit, wie dieser Nachbar die Synchronisierung durchführt, ist die Reaktion auf Änderungsbenachrichtigungen oder die manuell angeforderte Synchronisierung.

DS_REPL_NBR_COMPRESS_CHANGES

Von dieser Quelle empfangene Änderungen müssen komprimiert werden. Dies wird normalerweise festgelegt, wenn sich der Quellserver an einem anderen Standort befindet.

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

Von dieser Quelle sollten keine Änderungsbenachrichtigungen empfangen werden. Dies wird normalerweise festgelegt, wenn sich der Quellserver an einem anderen Standort befindet.

[in] ModifyFields

Gibt an, welche Felder geändert werden sollen. Mindestens ein Feld muss in ModifyFields angegeben werden. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

DS_REPMOD_UPDATE_ADDRESS

Updates die Adresse, die dem Server zugeordnet ist, auf den verwiesen wird.

DS_REPMOD_UPDATE_FLAGS

Updates die flags, die dem Replikat zugeordnet sind.

DS_REPMOD_UPDATE_RESULT

Wird nicht verwendet. Das Angeben von Aktualisierungen von Ergebniswerten wird derzeit nicht unterstützt. Die Ergebniswerte sind standardmäßig 0.

DS_REPMOD_UPDATE_SCHEDULE

Updates den regelmäßigen Replikationszeitplan, der dem Replikat zugeordnet ist.

DS_REPMOD_UPDATE_TRANSPORT

Updates den transport, der dem Replikat zugeordnet 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_REPMOD_ASYNCHRONOUS_OPERATION

Führt diesen Vorgang asynchron aus.

DS_REPMOD_WRITEABLE

Gibt an, dass das Replikat, in das geändert wird, geschrieben werden kann.

Rückgabewert

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

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein.

Hinweise

Hinweis

Der ntdsapi.h-Header definiert DsReplicaModify 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