DsReplicaSyncA-Funktion (ntdsapi.h)

Artikel
02/29/2024

Die DsReplicaSync-Funktion synchronisiert einen Zielbenennungskontext (Destination Naming Context, 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 von der FUNKTION DSBind oder DSBindWithCred abgerufen wurde.

[in] NameContext

Zeiger auf eine konstante NULL-Zeichenfolge, die den distinguished Name der Ziel-NC angibt.

[in] pUuidDsaSrc

Zeiger auf die UUID einer Quelle, die auf die Ziel-NC repliziert wird.

[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_REPSYNC_ADD_REFERENCE

Bewirkt, dass der Quellverzeichnissystem-Agent (DSA) überprüft, ob der lokale DSA in der Quellreplikationsliste vorhanden ist. Andernfalls 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 bei Verwendung von DS_REPSYNC_ALL_SOURCES.

DS_REPSYNC_FORCE

Synchronisiert auch dann, wenn der Link derzeit 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 es sich bei diesem Vorgang um eine vom Administrator geplante regelmäßige Synchronisierungsanforderung handelt.

DS_REPSYNC_URGENT

Gibt an, dass dieser Vorgang eine Benachrichtigung über ein Update ist, das als dringend gekennzeichnet ist.

DS_REPSYNC_WRITEABLE

Das Replikat ist beschreibbar. Andernfalls ist es schreibgeschützt.

Rückgabewert

Wenn die Funktion ihren 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.

Hinweise

Der Server, auf dem DsReplicaSync ausgeführt wird, wird als Ziel bezeichnet. Der Zielbenennungskontext wird in Bezug auf ein Quellsystem aktualisiert, das durch die UUID des NTDS-Einstellungsobjekts des Quellsystems identifiziert wird. Das Zielsystem muss bereits so konfiguriert sein, dass 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. Beispielsweise kann die Synchronisierung eines neuen Benutzers eine dringende Synchronisierung ausschließen, die ausgeführt wird, um einem kürzlich gesperrten Benutzer Zugriff zu gewähren oder ein neues Vertrauenskennwort hinzuzufügen. Wenn Sie diese API häufig aufrufen, können Sie das Netzwerk mit Anforderungen überfluten, die andere Replikationsvorgänge beeinträchtigen können. Aus diesem Grund wird dringend empfohlen, diese Funktion nur für Szenarien mit einmaliger Verwendung zu verwenden, anstatt sie in eine Anwendung zu integrieren, die sie regelmäßig verwenden würde.

Hinweis

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 nicht codierungsneutralem Code 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