DS_REPL_OPW-Struktur (ntdsapi.h)

Artikel
08/25/2023

Die DS_REPL_OP-Struktur beschreibt einen Replikationstask, der derzeit ausgeführt wird oder aussteht, wie er von der DsReplicaGetInfo - oder DsReplicaGetInfo2-Funktion zurückgegeben wird.

Syntax

typedef struct _DS_REPL_OPW {
  FILETIME        ftimeEnqueued;
  ULONG           ulSerialNumber;
  ULONG           ulPriority;
  DS_REPL_OP_TYPE OpType;
  ULONG           ulOptions;
  LPWSTR          pszNamingContext;
  LPWSTR          pszDsaDN;
  LPWSTR          pszDsaAddress;
  UUID            uuidNamingContextObjGuid;
  UUID            uuidDsaObjGuid;
} DS_REPL_OPW;

Member

ftimeEnqueued

Enthält eine FILETIME-Struktur , die das Datum und die Uhrzeit enthält, zu der dieser Vorgang der Warteschlange hinzugefügt wurde.

ulSerialNumber

Enthält den Vorgangsbezeichner. Dieser Wert ist in der Startroutine jedes Computers eindeutig. Wenn der Computer neu gestartet wird, sind die Bezeichner nicht mehr eindeutig.

ulPriority

Enthält den Prioritätswert dieses Vorgangs. Aufgaben mit einem höheren Prioritätswert werden zuerst ausgeführt. Die Priorität wird vom Server basierend auf dem Vorgangstyp und seinen Parametern berechnet.

OpType

Enthält einen der DS_REPL_OP_TYPE-Werte , die den Typ des Vorgangs angeben, den diese Struktur darstellt.

ulOptions

Null oder mehr Bits, deren Interpretation vom OpType abhängt. Für DS_REPL_OP_TYPE_SYNC sollten die Bits als DS_REPSYNC_ interpretiert werden. ADD, DELETE, MODIFY und UPDATE_REFS verwenden DS_REPADD_, DS_REPDEL_, DS_REPMOD_ und DS_REPUPD_*. Weitere Informationen und Beschreibungen dieser Bits finden Sie unter DsReplicaSync, DsReplicaAdd, DsReplicaDel, DsReplicaModify und DsReplicaUpdateRefs.

Enthält eine Reihe von Flags, die zusätzliche Daten zum Vorgang bereitstellt. Der Inhalt dieses Elements wird durch den Inhalt des OpType-Elements bestimmt.

DS_REPL_OP_TYPE_SYNC

Enthält null oder eine Kombination aus mindestens einem der DS_REPSYNC_* -Werte, die für den Optionsparameter in DsReplicaSync definiert sind.

DS_REPL_OP_TYPE_ADD

Enthält null oder eine Kombination aus mindestens einem der DS_REPADD_* -Werte, die für den Optionsparameter in DsReplicaAdd definiert sind.

DS_REPL_OP_TYPE_DELETE

Enthält null oder eine Kombination aus mindestens einem der DS_REPDEL_* -Werte, die für den Optionsparameter in DsReplicaDel definiert sind.

DS_REPL_OP_TYPE_MODIFY

Enthält null oder eine Kombination aus mindestens einem der DS_REPMOD_* -Werte, die für den Optionsparameter in DsReplicaModify definiert sind.

DS_REPL_OP_TYPE_UPDATE_REFS

Enthält null oder eine Kombination aus mindestens einem der DS_REPSUPD_* -Werte, die für den Options-Parameter in DsReplicaUpdateRefs definiert sind.

pszNamingContext

Zeiger auf eine NULL-beendete Zeichenfolge, die den distinguished Name des Namenskontexts enthält, der diesem Vorgang zugeordnet ist. Beispielsweise der Benennungskontext, der für DS_REPL_OP_TYPE_SYNC synchronisiert werden soll.

pszDsaDN

Zeiger auf eine NULL-beendete Zeichenfolge, die den distinguished Name des Verzeichnissystem-Agent-Objekts enthält, das dem Remoteserver zugeordnet ist, der diesem Vorgang entspricht. Beispielsweise der Server, von dem Änderungen für DS_REPL_OP_TYPE_SYNC anzufordern werden sollen. Dies kann NULL sein.

pszDsaAddress

Zeiger auf eine NULL-Zeichenfolge, die die transportspezifische Netzwerkadresse des diesem Vorgang zugeordneten Remoteservers enthält. Beispielsweise die DNS- oder SMTP-Adresse des Servers, von dem Änderungen für DS_REPL_OP_TYPE_SYNC. Dies kann NULL sein.

uuidNamingContextObjGuid

Enthält die objectGuid des Durch pszNamingContext identifizierten Benennungskontexts.

uuidDsaObjGuid

Enthält die objectGuid des Vom pszDsaDN identifizierten Verzeichnissystem-Agent-Objekts.