DsReplicaUpdateRefsA-Funktion (ntdsapi.h)
Die DsReplicaUpdateRefs Funktion fügt einen Replikationsverweis für ein Ziel aus einem Quellbenennungskontext hinzu oder entfernt sie.
NTDSAPI DWORD DsReplicaUpdateRefsA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR DsaDest,
[in] const UUID *pUuidDsaDest,
[in] ULONG Options
);
[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.
Dem Quellserver wird ein Verweis auf das Ziel hinzugefügt.
Der Vorgang wird asynchron ausgeführt.
Ein Verweis auf das Ziel wird vom Quellserver entfernt.
Der Verweis auf das hinzugefügte oder entfernte Replikat ist schreibbar. Andernfalls ist sie schreibgeschützt.
Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.
Wenn die Funktion fehlschlägt, kann der Rückgabewert eine der folgenden Sein:
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.
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 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.
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 |