Directory Services

DS_REPL_CURSOR_BLOB

The DS_REPL_CURSOR_BLOB structure contains inbound replication state data with respect to all replicas of a given naming context. This structure is similar to the DS_REPL_CURSOR_3 structure, but is obtained from the Lightweight Directory Access Protocol API functions when obtaining binary data for the msDS-NCReplCursors attribute.

typedef struct {
UUID uuidSourceDsaInvocationID;
USN usnAttributeFilter;
FILETIME ftimeLastSyncSuccess;
DWORD oszSourceDsaDN; } DS_REPL_CURSOR_BLOB;

Members

uuidSourceDsaInvocationID
Contains the invocation identifier of the originating server to which the usnAttributeFilter corresponds.
usnAttributeFilter
Contains the maximum update sequence number to which the destination server can indicate that it has recorded all changes originated by the given server at update sequence numbers less than, or equal to, this update sequence number. This is used to filter changes at replication source servers that the destination server has already applied.
ftimeLastSyncSuccess
Contains a FILETIME structure that contains the date and time of the last successful synchronization operation.
oszSourceDsaDN
Contains the offset, in bytes, from the address of this structure to a null-terminated Unicode string that contains the distinguished name of the directory service agent that corresponds to the source server to which this replication state data applies.

Example Code [C++]

The following code example demonstrates how to access the directory service agent distinguished name string using the oszSourceDsaDN member.

DS_REPL_CURSOR_BLOB *pdsReplCurBlob;

// Retrieve the replication data into pdsReplCurBlob.

LPWSTR pwszSourceDsaDN = (LPWSTR)((LPBYTE)pdsReplCurBlob + pdsReplCurBlob->oszSourceDsaDN);

Requirements

Client: Included in Windows XP.
Server: Included in Windows Server 2003.
Header: Declared in Ntdsapi.h.

See Also

DS_REPL_CURSOR_3, FILETIME, Lightweight Directory Access Protocol API