DS_REPL_KCC_DSA_FAILUREW structure (ntdsapi.h)

The DS_REPL_KCC_DSA_FAILURE structure contains replication state data about a specific inbound replication partner, as returned by the DsReplicaGetInfo and DsReplicaGetInfo2 function. 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.

Syntax

typedef struct _DS_REPL_KCC_DSA_FAILUREW {
  LPWSTR   pszDsaDN;
  UUID     uuidDsaObjGuid;
  FILETIME ftimeFirstFailure;
  DWORD    cNumFailures;
  DWORD    dwLastResult;
} DS_REPL_KCC_DSA_FAILUREW;

Members

pszDsaDN

Pointer 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 pszDsaDN member.

ftimeFirstFailure

Contains a FILETIME structure which the contents of depends on the value passed for the InfoType parameter when DsReplicaGetInfo or DsReplicaGetInfo2 function was called.

DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES

Contains the date and time that the first failure occurred when replicating from the source server.

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

See also

DS_REPL_KCC_DSA_FAILURES

DsReplicaGetInfo

DsReplicaGetInfo2

FILETIME