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 entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.
[in] NameContext
Zeigen Sie auf eine konstante null-beendete Zeichenfolge, die den distinguishierten Namen des Quellbenennungskontexts angibt.
[in] DsaDest
Zeigen Sie auf eine konstante null-beendete Zeichenfolge, die die transportspezifische Adresse des Zielverzeichnissystem-Agents angibt.
[in] pUuidDsaDest
Zeigen Sie auf einen UUID- Wert, der den Zielverzeichnissystem-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 schreibbar. Andernfalls ist sie schreibgeschützt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.
Wenn die Funktion fehlschlägt, kann der Rückgabewert eine der folgenden Sein:
Bemerkungen
Wenn sowohl DS_REPUPD_ADD_REFERENCE als auch DS_REPUPD_DELETE_REFERENCE im parameter Options festgelegt sind, wird ein Verweis auf das Ziel hinzugefügt, wenn auf dem Server noch kein Verweis vorhanden ist. Wenn bereits ein Verweis auf das Ziel vorhanden ist, wird der Verweis aktualisiert.
Anmerkung
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 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 |