DS_REPL_OPW structure (ntdsapi.h)

Article
10/05/2021

The DS_REPL_OP structure describes a replication task currently executing or pending execution, as returned by the DsReplicaGetInfo or DsReplicaGetInfo2 function.

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;

Members

ftimeEnqueued

Contains a FILETIME structure that contains the date and time that this operation was added to the queue.

ulSerialNumber

Contains the operation identifier. This value is unique in the startup routine of every computer. When the computer is restarted, the identifiers are no longer unique.

ulPriority

Contains the priority value of this operation. Tasks with a higher priority value are executed first. The priority is calculated by the server based on the type of operation and its parameters.

OpType

Contains one of the DS_REPL_OP_TYPE values that indicate the type of operation that this structure represents.

ulOptions

Zero or more bits, the interpretation of which depends on the OpType. For DS_REPL_OP_TYPE_SYNC, the bits should be interpreted as DS_REPSYNC_. ADD, DELETE, MODIFY, and UPDATE_REFS use DS_REPADD_, DS_REPDEL_, DS_REPMOD_, and DS_REPUPD_*. For more information and descriptions of these bits, see DsReplicaSync, DsReplicaAdd, DsReplicaDel, DsReplicaModify, and DsReplicaUpdateRefs.

Contains a set of flags that provides additional data about the operation. The contents of this member is determined by the contents of the OpType member.

DS_REPL_OP_TYPE_SYNC

Contains zero or a combination of one or more of the DS_REPSYNC_* values as defined for the Options parameter in DsReplicaSync.

DS_REPL_OP_TYPE_ADD

Contains zero or a combination of one or more of the DS_REPADD_* values as defined for the Options parameter in DsReplicaAdd.

DS_REPL_OP_TYPE_DELETE

Contains zero or a combination of one or more of the DS_REPDEL_* values as defined for the Options parameter in DsReplicaDel.

DS_REPL_OP_TYPE_MODIFY

Contains zero or a combination of one or more of the DS_REPMOD_* values as defined for the Options parameter in DsReplicaModify.

DS_REPL_OP_TYPE_UPDATE_REFS

Contains zero or a combination of one or more of the DS_REPSUPD_* values as defined for the Options parameter in DsReplicaUpdateRefs.

pszNamingContext

Pointer to a null-terminated string that contains the distinguished name of the naming context associated with this operation. For example, the naming context to be synchronized for DS_REPL_OP_TYPE_SYNC.

pszDsaDN

Pointer to a null-terminated string that contains the distinguished name of the directory system agent object associated with the remote server corresponding to this operation. For example, the server from which to request changes for DS_REPL_OP_TYPE_SYNC. This can be NULL.

pszDsaAddress

Pointer to a null-terminated string that contains the transport-specific network address of the remote server associated with this operation. For example, the DNS or SMTP address of the server from which to request changes for DS_REPL_OP_TYPE_SYNC. This can be NULL.

uuidNamingContextObjGuid

Contains the objectGuid of the naming context identified by pszNamingContext.

uuidDsaObjGuid

Contains the objectGuid of the directory system agent object identified by pszDsaDN.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	ntdsapi.h

Share via