DsReplicaModifyA-Funktion (ntdsapi.h)
Die DsReplicaModify-Funktion ändert einen vorhandenen Replikationsquellenverweis für einen Zielbenennungskontext.
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 entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.
[in] NameContext
Zeigen Sie auf eine konstante null-beendete Zeichenfolge, die den Distinguished Name (DN) des Zielbenennungskontexts (NC) angibt.
[in] pUuidSourceDsa
Zeiger auf die UUID des Quellverzeichnissystem-Agents (DSA). Dieser Parameter kann null sein, wenn ModifyFields nicht DS_REPMOD_UPDATE_ADDRESS enthält und SourceDsaAddress- nicht NULL-ist.
[in] TransportDn
Reserviert für die zukünftige Verwendung. Ein anderer Wert als NULL- führt dazu, dass ERROR_NOT_SUPPORTED zurückgegeben werden.
[in] SourceDsaAddress
Zeiger auf eine konstante mit Null beendete Unicode-Zeichenfolge, die die transportspezifische Adresse der DSA-Quelle angibt. Dieser Parameter wird ignoriert, wenn pUuidSourceDsa- nicht NULL- ist und ModifyFields- nicht DS_REPMOD_UPDATE_ADDRESSenthält.
[in] pSchedule
Zeiger auf eine SCHEDULE Struktur, die die Replikationszeitplandaten für die Replikationsquelle enthält. Dieser Parameter ist optional und kann bei Verwendung NULL- werden. Dieser Parameter ist erforderlich, wenn ModifyFields- das DS_REPMOD_UPDATE_SCHEDULE Flag 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 standortinterne Nachbarn.
DS_REPL_NBR_DO_SCHEDULED_SYNCS
Führen Sie die Replikation nach einem Zeitplan aus. Dieses Kennzeichen wird normalerweise festgelegt, es sei denn, der Zeitplan für diesen Namenskontext und die Quelle ist "nie", 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, die Synchronisierung in umgekehrter Richtung durchzuführen. Dieses Feature wird in DFÜ-Szenarien verwendet, in denen nur eins der beiden Server eine DFÜ-Verbindung initiieren kann. Diese Option wird z. B. in einem Unternehmenssitz und einer Zweigstelle verwendet, bei der die Zweigstelle über das Internet über eine DFÜ-Verbindung mit dem Unternehmenssitz verbunden ist.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
Dieser Nachbar ist so festgelegt, dass die Benachrichtigungsbasierte Synchronisierung deaktiviert wird. Innerhalb eines Standorts werden Domänencontroller basierend auf Benachrichtigungen, wenn Änderungen auftreten, miteinander synchronisiert. Diese Einstellung verhindert, dass dieser Nachbar eine durch eine Benachrichtigung ausgelöste Synchronisierung durchführt. Der Nachbar führt die Synchronisierung weiterhin basierend auf seinem Zeitplan oder als Reaktion auf manuell angeforderte Synchronisierung durch.
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
Dieser Nachbar ist so eingestellt, dass keine Synchronisierung basierend auf seinem Zeitplan ausgeführt wird. Die einzige Möglichkeit, wie dieser Nachbar die Synchronisierung durchführt, ist als Reaktion auf Änderungsbenachrichtigungen oder manuell angeforderte Synchronisierung.
DS_REPL_NBR_COMPRESS_CHANGES
Von dieser Quelle empfangene Änderungen werden komprimiert. 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. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.
DS_REPMOD_UPDATE_ADDRESS
Aktualisiert die Adresse, die dem referenzierten Server zugeordnet ist.
DS_REPMOD_UPDATE_FLAGS
Aktualisiert 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. Ergebniswerte werden standardmäßig auf 0 festgelegt.
DS_REPMOD_UPDATE_SCHEDULE
Aktualisiert den regelmäßigen Replikationszeitplan, der dem Replikat zugeordnet ist.
DS_REPMOD_UPDATE_TRANSPORT
Aktualisiert den mit dem Replikat verknüpften Transport.
[in] Options
Übergibt zusätzliche Daten, die zum Verarbeiten der Anforderung verwendet werden. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.
DS_REPMOD_ASYNCHRONOUS_OPERATION
Führt diesen Vorgang asynchron aus.
DS_REPMOD_WRITEABLE
Gibt an, dass das zu ändernde Replikat 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 eine der folgenden Sein:
Bemerkungen
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | ntdsapi.h |
| Library | Ntdsapi.lib |
| DLL- | Ntdsapi.dll |