DS_REPL_NEIGHBORW-Struktur (ntdsapi.h)
Die DS_REPL_NEIGHBOR-Struktur enthält Daten zum Eingehenden Replikationsstatus für einen bestimmten Namenskontext und ein Quellserverpaar, wie von den Funktionen DsReplicaGetInfo und DsReplicaGetInfo2 zurückgegeben.
Syntax
typedef struct _DS_REPL_NEIGHBORW {
LPWSTR pszNamingContext;
LPWSTR pszSourceDsaDN;
LPWSTR pszSourceDsaAddress;
LPWSTR pszAsyncIntersiteTransportDN;
DWORD dwReplicaFlags;
DWORD dwReserved;
UUID uuidNamingContextObjGuid;
UUID uuidSourceDsaObjGuid;
UUID uuidSourceDsaInvocationID;
UUID uuidAsyncIntersiteTransportObjGuid;
USN usnLastObjChangeSynced;
USN usnAttributeFilter;
FILETIME ftimeLastSyncSuccess;
FILETIME ftimeLastSyncAttempt;
DWORD dwLastSyncResult;
DWORD cNumConsecutiveSyncFailures;
} DS_REPL_NEIGHBORW;
Member
pszNamingContext
Zeiger auf eine NULL-endende Zeichenfolge, die den Namenskontext enthält, auf den sich diese Replikationsstatusdaten beziehen. Jeder Namenskontext wird unabhängig repliziert und verfügt über unterschiedliche zugeordnete Nachbardaten, auch wenn die Namenskontexte vom gleichen Quellserver repliziert werden.
pszSourceDsaDN
Zeiger auf eine NULL-endende Zeichenfolge, die den distinguished Name des Verzeichnisdienst-Agents enthält, der dem Quellserver entspricht, auf den sich diese Replikationsstatusdaten beziehen. Jeder Quellserver verfügt über unterschiedliche zugeordnete Nachbardaten.
pszSourceDsaAddress
Zeiger auf eine NULL-endende Zeichenfolge, die die transportspezifische Netzwerkadresse des Quellservers enthält. Dies ist ein Name des Verzeichnisnamendiensts für die RPC/IP-Replikation oder eine SMTP-Adresse für eine SMTP-Replikation.
pszAsyncIntersiteTransportDN
Zeiger auf eine NULL-endende Zeichenfolge, die den distinguished Name des interSiteTransport-Objekts enthält, der dem Transport entspricht, über den die Replikation ausgeführt wird. Dieser Member enthält NULL für die RPC/IP-Replikation.
dwReplicaFlags
Enthält eine Reihe von Flags, die Attribute und Optionen für die Replikationsdaten angeben. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Flags sein.
DS_REPL_NBR_WRITEABLE (16 (0x10))
Die lokale Kopie des Namenskontexts ist nicht schreibgeschützt.
DS_REPL_NBR_SYNC_ON_STARTUP (32 (0x20))
Die Replikation dieses Namenskontexts aus dieser Quelle wird versucht, wenn der Zielserver gestartet wird. Dies gilt normalerweise nur für standortübergreifende Nachbarn.
DS_REPL_NBR_DO_SCHEDULED_SYNCS (64 (0x40))
Die Replikation nach einem Zeitplan ausführen. Dieses Flag wird normalerweise festgelegt, es sei denn, der Zeitplan für diesen Namenskontext bzw. diese Quelle lautet "never", d. h. der leere Zeitplan.
DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT (128 (0x80))
Die Replikation indirekt über den standortübergreifenden Meldungsdienst ausführen. Dieses Flag wird nur festgelegt, wenn über SMTP repliziert wird. Dieses Flag wird nicht festgelegt, wenn über standortübergreifendes RPC/IP repliziert wird.
DS_REPL_NBR_TWO_WAY_SYNC (512 (0x200))
Wenn festgelegt, gibt an, dass der Zielserver nach Abschluss der eingehenden Replikation den Quellserver anweisen muss, in umgekehrter Richtung zu synchronisieren. Dieses Feature wird in DFÜ-Szenarien verwendet, in denen nur einer der beiden Server eine DFÜ-Verbindung initiieren kann. Diese Option würde z. B. in einer Konzernzentrale und einer Zweigstelle verwendet werden, wenn die Zweigstelle über eine DFÜ-ISP-Verbindung eine Verbindung mit der Konzernzentrale herstellt.
DS_REPL_NBR_RETURN_OBJECT_PARENTS (2048 (0x800))
Dieser Nachbar befindet sich in einem Zustand, in dem er vor untergeordneten Objekten übergeordnete Objekte zurückgibt. Der Nachbar wechselt in diesen Zustand, nachdem er ein untergeordnetes Element vor dem zugehörigen übergeordneten Element empfangen hat.
DS_REPL_NBR_FULL_SYNC_IN_PROGRESS (65536 (0x10000))
Der Zielserver führt eine vollständige Synchronisierung vom Quellserver aus. Vollständige Synchronisierungen verwenden keine Vektoren, die Updates (DS_REPL_CURSORS) zum Filtern von Updates erstellen. Vollständige Synchronisierungen werden nicht als Teil des normalen Replikationsprotokolls verwendet.
DS_REPL_NBR_FULL_SYNC_NEXT_PACKET (131072 (0x20000))
Das letzte Paket aus der Quelle weist auf eine Änderung eines Objekts hin, das der Zielserver noch nicht erstellt hat. Das nächste angeforderte Paket weist den Quellserver an, alle Attribute des geänderten Objekts in das Paket einzufügen.
DS_REPL_NBR_NEVER_SYNCED (2097152 (0x200000))
Eine Synchronisierung ist von dieser Quelle nie erfolgreich abgeschlossen worden.
DS_REPL_NBR_PREEMPTED (16777216 (0x1000000))
Die Replikations-Engine hat die Verarbeitung dieses Nachbars vorübergehend beendet, um einen anderen Nachbarn mit höherer Priorität zu warten, entweder für diese Partition oder für eine andere Partition. Die Replikations-Engine fährt mit der Verarbeitung dieses Nachbarn fort, nachdem die Arbeit mit der höheren Priorität abgeschlossen wurde.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS (67108864 (0x4000000))
Dieser Nachbar ist so festgelegt, dass benachrichtigungsbasierte Synchronisierungen deaktiviert werden. Innerhalb eines Standorts werden Domänencontroller bei Vornahme von Änderungen auf Grundlage von Benachrichtigungen miteinander synchronisiert. Durch diese Einstellung wird verhindert, dass dieser Nachbar Synchronisierungen ausführt, die von Benachrichtigungen ausgelöst werden. Der Nachbar führt weiterhin Synchronisierungen basierend auf seinem Zeitplan oder als Reaktion auf manuell angeforderte Synchronisierungen durch.
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC (134217728 (0x8000000))
Dieser Nachbar ist so festgelegt, dass keine Synchronisierungen basierend auf seinem Zeitplan ausgeführt werden. Die einzige Möglichkeit, wie dieser Nachbar Synchronisierungen durchführt, ist die Reaktion auf Änderungsbenachrichtigungen oder manuell angeforderte Synchronisierungen.
DS_REPL_NBR_COMPRESS_CHANGES (268435456 (0x10000000))
Von dieser Quelle empfangene Änderungen müssen komprimiert werden. Dies wird normalerweise festgelegt, wenn sich der Quellserver an einem anderen Standort befindet.
DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS (536870912 (0x20000000))
Von dieser Quelle sollten keine Änderungsbenachrichtigungen empfangen werden. Legen Sie normalerweise fest, ob sich der Quellserver an einem anderen Standort befindet.
DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET (1073741824 (0x40000000))
Dieser Nachbar befindet sich in einem Zustand, in dem er den Inhalt dieses Replikats aufgrund einer Änderung im Teilattributsatz neu erstellt.
dwReserved
Für die zukünftige Verwendung reserviert.
uuidNamingContextObjGuid
Enthält die objectGuid des Namenskontexts, der pszNamingContext entspricht.
uuidSourceDsaObjGuid
Enthält die objectGuid des nTDSDSA-Objekts , das pszSourceDsaDN entspricht.
uuidSourceDsaInvocationID
Enthält den Aufrufbezeichner, der vom Quellserver beim letzten Replikationsversuch verwendet wurde.
uuidAsyncIntersiteTransportObjGuid
Enthält die objectGuid des standortübergreifenden Transportobjekts, das pszAsyncIntersiteTransportDN entspricht.
usnLastObjChangeSynced
Enthält die Updatesequenznummer des letzten empfangenen Objektupdates.
usnAttributeFilter
Enthält den UsnLastObjChangeSynced-Wert am Ende des letzten abgeschlossenen, erfolgreichen Replikationszyklus oder 0, wenn keiner. Attribute an der Quelle, die zuletzt mit einer Updatesequenznummer aktualisiert wurden, die kleiner oder gleich diesem Wert ist, wurden bereits empfangen und vom Ziel angewendet.
ftimeLastSyncSuccess
Enthält eine FILETIME-Struktur , die das Datum und die Uhrzeit des letzten erfolgreichen Replikationszyklus aus dieser Quelle enthält. Alle Member dieser Struktur sind null, wenn der Replikationszyklus nie abgeschlossen wurde.
ftimeLastSyncAttempt
Enthält eine FILETIME-Struktur , die das Datum und die Uhrzeit des letzten Replikationsversuchs aus dieser Quelle enthält. Alle Member dieser Struktur sind null, wenn die Replikation noch nie versucht wurde.
dwLastSyncResult
Enthält einen Fehlercode, der dem letzten Replikationsversuch aus dieser Quelle zugeordnet ist. Enthält ERROR_SUCCESS , wenn der letzte Versuch erfolgreich war.
cNumConsecutiveSyncFailures
Enthält die Anzahl der fehlgeschlagenen Replikationsversuche aus dieser Quelle seit dem letzten erfolgreichen Replikationsversuch oder seit dem Hinzufügen der Quelle als Nachbar, wenn kein vorheriger Versuch erfolgreich war.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Kopfzeile | ntdsapi.h |