Directory Services

DS_REPL_OP

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

typedef struct _DS_REPL_OP {
FILETIME ftimeEnqueued;
ULONG ulSerialNumber;
ULONG ulPriority;
DS_REPL_OP_TYPE OpType;
ULONG ulOptions;
LPTSTR pszNamingContext;
LPTSTR pszDsaDN;
LPTSTR pszDsaAddress;
UUID uuidNamingContextObjGuid;
UUID uuidDsaObjGuid; } DS_REPL_OP;

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 within within a boot of a computer. When the computer is rebooted, 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.

OpType value ulOptions description
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

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Unicode: Declared only as Unicode.
Header: Declared in Ntdsapi.h.

See Also

DsReplicaGetInfo, DsReplicaGetInfo2, FILETIME, DS_REPL_OP_TYPE, DsReplicaSync, DsReplicaAdd, DsReplicaDel, DsReplicaModify, DsReplicaUpdateRefs, DS_REPL_PENDING_OPS