DsReplicaUpdateRefsA-Funktion (ntdsapi.h)
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 |