Directory Services

DS_REPL_KCC_DSA_FAILUREW_BLOB

The DS_REPL_KCC_DSA_FAILUREW_BLOB structure contains replication state data with respect to a specific inbound replication partner. This state data is compiled and used by the Knowledge Consistency Checker (KCC) to decide when alternate replication routes need to be added to account for unreachable servers. This structure is similar to the DS_REPL_KCC_DSA_FAILURE structure, but is obtained from the Lightweight Directory Access Protocol API functions when obtaining binary data for the msDS-ReplConnectionFailures or msDS-ReplLinkFailures attribute.

typedef struct {
DWORD oszDsaDN;
UUID uuidDsaObjGuid;
FILETIME ftimeFirstFailure;
DWORD cNumFailures;
DWORD dwLastResult; } DS_REPL_KCC_DSA_FAILUREW_BLOB;

Members

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 in the directory that corresponds to the source server.
uuidDsaObjGuid
Contains the objectGuid of the directory system agent object repesented by the oszDsaDN member.
ftimeFirstFailure
Contains a FILETIME structure which the contents of depends on the binary replication data that was requested.
Value Meaning
msDS-ReplConnectionFailures Contains the date and time that the first failure occurred when replicating from the source server.
msDS-ReplLinkFailures Contains the date and time of the last successful replication.
cNumFailures
Contains the number of consecutive failures since the last successful replication.
dwLastResult
Contains the error code associated with the most recent failure, or ERROR_SUCCESS if the specific error is unavailable.

Example Code [C++]

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

DS_REPL_KCC_DSA_FAILUREW_BLOB *pdsReplKccDsaFailure;

// Retrieve the replication data into pdsReplKccDsaFailure.

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

Requirements

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

See Also

DS_REPL_KCC_DSA_FAILURE, FILETIME, Lightweight Directory Access Protocol API