Export (0) Print
Expand All

DS_REPL_OPW_BLOB structure

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 {
  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.

OpType valueulOptions 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.

 

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.

Examples

The following code example shows how to access the strings in this structure using the offset members.


DS_REPL_OPW_BLOB *pReplOpwBlob;

// Retrieve the replication data into pReplOpwBlob.

LPWSTR pwszNamingContext = (LPWSTR)((LPBYTE)pReplOpwBlob + 
    pReplOpwBlob->oszNamingContext);

LPWSTR pwszDsaAddress = (LPWSTR)((LPBYTE)pReplOpwBlob + 
    pReplOpwBlob->oszDsaAddress);

LPWSTR pwszDsaDN = (LPWSTR)((LPBYTE)pReplOpwBlob + 
    pReplOpwBlob->oszDsaDN);


Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntdsapi.h

See also

DS_REPL_OP
FILETIME
Lightweight Directory Access Protocol API

 

 

Show:
© 2014 Microsoft