DsReplicaUpdateRefsA-Funktion (ntdsapi.h)

Artikel
08/25/2023

Die DsReplicaUpdateRefs-Funktion fügt einen Replikationsverweis für ein Ziel aus einem Quellbenennungskontext hinzu oder entfernt sie.

Syntax

NTDSAPI DWORD DsReplicaUpdateRefsA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] LPCSTR     DsaDest,
  [in] const UUID *pUuidDsaDest,
  [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 des Quellbenennungskontexts angibt.

[in] DsaDest

Zeiger auf eine konstante null-beendete Zeichenfolge, die die transportspezifische Adresse des Zielverzeichnis-System-Agents angibt.

[in] pUuidDsaDest

Zeiger auf einen UUID-Wert , der den Zielverzeichnis-System-Agent enthält.

[in] Options

Enthält eine Reihe von Flags, die zusätzliche Daten bereitstellen, die zum Verarbeiten der Anforderung verwendet werden. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DS_REPUPD_ADD_REFERENCE

Dem Quellserver wird ein Verweis auf das Ziel hinzugefügt.

DS_REPUPD_ASYNCHRONOUS_OPERATION

Der Vorgang wird asynchron ausgeführt.

DS_REPUPD_DELETE_REFERENCE

Ein Verweis auf das Ziel wird vom Quellserver entfernt.

DS_REPUPD_WRITEABLE

Der Verweis auf das hinzugefügte oder entfernte Replikat ist beschreibbar. Andernfalls ist es schreibgeschützt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein.

Hinweise

Wenn im Options-Parameter sowohl DS_REPUPD_ADD_REFERENCE als auch DS_REPUPD_DELETE_REFERENCE festgelegt sind, wird ein Verweis auf das Ziel hinzugefügt, sofern noch keins auf dem Server vorhanden ist. Wenn bereits ein Verweis auf das Ziel vorhanden ist, wird der Verweis aktualisiert.

Hinweis

Der ntdsapi.h-Header definiert DsReplicaUpdateRefs als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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