DS_REPL_OPW_BLOB structure (ntdsapi.h)

The DS_REPL_OPW_BLOB structure describes a replication task currently executing or pending execution. This structure is similar to the DS_REPL_OP structure, but is obtained from the Lightweight Directory Access Protocol API functions when obtaining binary data for the msDS-ReplPendingOps attribute.

Syntax

typedef struct _DS_REPL_OPW_BLOB {
  FILETIME        ftimeEnqueued;
  ULONG           ulSerialNumber;
  ULONG           ulPriority;
  DS_REPL_OP_TYPE OpType;
  ULONG           ulOptions;
  DWORD           oszNamingContext;
  DWORD           oszDsaDN;
  DWORD           oszDsaAddress;
  UUID            uuidNamingContextObjGuid;
  UUID            uuidDsaObjGuid;
} DS_REPL_OPW_BLOB;

Members

ftimeEnqueued

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

ulSerialNumber

Contains the identifier of the operation. 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 provide additional data about the operation. The contents of this member is determined by the contents of the OpType member.

This list describes the contents of the ulOptions parameter for each OpType value.

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.

oszNamingContext

Contains the offset, in bytes, from the address of this structure 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.

oszDsaDN

Contains the offset, in bytes, from the address of this structure 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 ask for changes for DS_REPL_OP_TYPE_SYNC. This can be NULL.

oszDsaAddress

Contains the offset, in bytes, from the address of this structure 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 ask for 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

See also

DS_REPL_OP

FILETIME

Lightweight Directory Access Protocol API