Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die DsReplicaSync--Funktion synchronisiert einen Zielbenennungskontext (NC) mit einer seiner Quellen.
Syntax
NTDSAPI DWORD DsReplicaSyncW(
[in] HANDLE hDS,
[in] LPCWSTR NameContext,
[in] const UUID *pUuidDsaSrc,
[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 des Ziel-NC angibt.
[in] pUuidDsaSrc
Zeigen Sie auf die UUID einer Quelle, die in die Ziel-NC repliziert wird.
[in] Options
Übergibt zusätzliche Daten, die zum Verarbeiten der Anforderung verwendet werden. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.
DS_REPSYNC_ADD_REFERENCE
Bewirkt, dass der Quellverzeichnissystem-Agent (DSA) überprüft, ob die lokale DSA in der Quellreplikationsliste vorhanden ist. Wenn nicht, wird die lokale DSA hinzugefügt. Dadurch wird sichergestellt, dass die Quelle Änderungsbenachrichtigungen sendet.
DS_REPSYNC_ALL_SOURCES
Dieser Wert wird nicht unterstützt.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista und Windows Server 2003: Synchronisiert aus allen Quellen.
DS_REPSYNC_ASYNCHRONOUS_OPERATION
Führt diesen Vorgang asynchron aus.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista und Windows Server 2003: Erforderlich, wenn sie DS_REPSYNC_ALL_SOURCESverwenden.
DS_REPSYNC_FORCE
Synchronisiert, auch wenn der Link zurzeit deaktiviert ist.
DS_REPSYNC_FULL
Synchronisiert ab der ersten Updatesequenznummer (USN).
DS_REPSYNC_INTERSITE_MESSAGING
Synchronisiert mithilfe eines ISM.
DS_REPSYNC_NO_DISCARD
Verwirft diese Synchronisierungsanforderung nicht, auch wenn eine ähnliche Synchronisierung aussteht.
DS_REPSYNC_PERIODIC
Gibt an, dass dieser Vorgang eine regelmäßige Synchronisierungsanforderung ist, wie vom Administrator geplant.
DS_REPSYNC_URGENT
Gibt an, dass dieser Vorgang eine Benachrichtigung über eine dringend markierte Aktualisierung ist.
DS_REPSYNC_WRITEABLE
Replikat ist schreibbar. Andernfalls ist sie schreibgeschützt.
Rückgabewert
Wenn die Funktion den Vorgang erfolgreich ausführt, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der standardmäßigen Win32-API-Fehler.
Bemerkungen
Der Server, auf dem dsReplicaSync ausgeführt wird
Hinweis Das Erzwingen der manuellen Synchronisierung kann verhindern, dass der Verzeichnisdienst Replikationsvorgänge ordnungsgemäß priorisiert. Die Synchronisierung eines neuen Benutzers kann z. B. eine dringende Synchronisierung, die ausgeführt wird, um den Zugriff auf einen kürzlich gesperrten Benutzer zu ermöglichen oder ein neues Vertrauenskennwort hinzuzufügen. Wenn Sie diese API häufig aufrufen, können Sie das Netzwerk mit Anforderungen überfluten, was andere Replikationsvorgänge beeinträchtigen kann. Aus diesem Grund wird dringend empfohlen, diese Funktion nur für Einzelverwendungsszenarien zu verwenden, anstatt sie regelmäßig in eine Anwendung zu integrieren, die sie regelmäßig verwenden würde.
Anmerkung
Der ntdsapi.h-Header definiert DsReplicaSync 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 |