DS_REPL_VALUE_META_DATA_BLOB

The DS_REPL_VALUE_META_DATA_BLOB structure is used to contain attribute value replication metadata. This structure is similar to the DS_REPL_VALUE_META_DATA_2 structure, but is obtained from the Lightweight Directory Access Protocol API functions when obtaining binary data for the msDS-ReplValueMetaData attribute.

typedef struct {

  DWORD oszAttributeName;

  DWORD oszObjectDn;

  DWORD cbData;

  BYTE* pbData;

  FILETIME ftimeDeleted;

  FILETIME ftimeCreated;

  DWORD dwVersion;

  FILETIME ftimeLastOriginatingChange;

  UUID uuidLastOriginatingDsaInvocationID;

  USN usnOriginatingChange;

  USN usnLocalChange;

  DWORD oszLastOriginatingDsaDN;
} DS_REPL_VALUE_META_DATA_BLOB;

Members

oszAttributeName

Contains the offset, in bytes, from the address of this structure to a null-terminated Unicode string that contains the LDAP display name of the attribute corresponding to this metadata.

oszObjectDn

Contains the offset, in bytes, from the address of this structure to a null-terminated Unicode string that contains the distingusihed name of the object that this attribute belongs to.

cbData

Contains the number of bytes in the pbData array.

pbData

Pointer to a buffer that contains the attribute replication metadata. The cbData member contains the length, in bytes, of this buffer.

ftimeDeleted

Contains a FILETIME structure that contains the time that this attribute was deleted.

ftimeCreated

Contains a FILETIME structure that contains the time that this attribute was created.

dwVersion

Contains the version of this attribute. Each originating modification of the attribute increases this value by one. Replication of a modification does not affect the version.

ftimeLastOriginatingChange

Contains a FILETIME structure that contains the time at which the last originating change was made to this attribute. Replication of the change does not affect this value.

uuidLastOriginatingDsaInvocationID

Contains the invocation identifier of the server on which the last change was made to this attribute. Replication of the change does not affect this value.

usnOriginatingChange

Contains the update sequence number (USN) on the originating server at which the last change to this attribute was made. Replication of the change does not affect this value.

usnLocalChange

Contains the USN on the destination server, that is, the server from which the DsReplicaGetInfo2 function retrieved the metadata, at which the last change to this attribute was applied. This value is typically different on all servers.

oszLastOriginatingDsaDN

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 system agent server that originated the last replication.

Example Code [C++]

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

DS_REPL_VALUE_META_DATA_BLOB *pReplValueMetaDataBlob;

// Retrieve the replication data into pReplValueMetaDataBlob.

LPWSTR pwszAttributeName = (LPWSTR)((LPBYTE)pReplValueMetaDataBlob + pReplValueMetaDataBlob->oszAttributeName);
LPWSTR pwszObjectDN = (LPWSTR)((LPBYTE)pReplValueMetaDataBlob + pReplValueMetaDataBlob->oszObjectDn);
LPWSTR pwszLastOriginatingDsaDN = (LPWSTR)((LPBYTE)pReplValueMetaDataBlob + pReplValueMetaDataBlob->oszLastOriginatingDsaDN);

Requirements

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

See Also

DS_REPL_VALUE_META_DATA_2, FILETIME, Lightweight Directory Access Protocol API