DsReplicaSyncA-Funktion (ntdsapi.h)

Artikel
11/20/2024

Die DsReplicaSync--Funktion synchronisiert einen Zielbenennungskontext (NC) mit einer seiner Quellen.

Syntax

NTDSAPI DWORD DsReplicaSyncA(
  [in] HANDLE     hDS,
  [in] LPCSTR     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 , wird als Ziel bezeichnet. Der Zielbenennungskontext wird up-to-datum in Bezug auf ein Quellsystem gebracht, das durch die UUID des NTDS-Einstellungsobjekts des Quellsystems identifiziert wird. Das Zielsystem muss bereits konfiguriert werden, damit das Quellsystem eines der Systeme ist, von denen es Replikationsdaten empfängt.

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