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