DS_REPL_KCC_DSA_FAILUREW_BLOB structure (ntdsapi.h)

Article
10/05/2021

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

Syntax

typedef struct _DS_REPL_KCC_DSA_FAILUREW_BLOB {
  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 represented by the oszDsaDN member.

ftimeFirstFailure

Contains a FILETIME structure which the contents of depends on the requested binary replication data.

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.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	ntdsapi.h