Directory Services

DS_REPL_KCC_DSA_FAILURE

The DS_REPL_KCC_DSA_FAILURE structure contains replication state data with respect to 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 need to be added to account for unreachable servers.

typedef struct _DS_REPL_KCC_DSA_FAILUREW {
LPTSTR 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 corresponding to the source server.
uuidDsaObjGuid
Contains the objectGuid of the directory system agent object repesented 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.
Value Meaning
DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES Contains the date and time that the first failure occurred when replicating from the source server.
DS_REPL_INFO_KCC_DSA_LINK_FAILURES 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

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Unicode: Declared only as Unicode.
Header: Declared in Ntdsapi.h.

See Also

DS_REPL_KCC_DSA_FAILURES, DsReplicaGetInfo, DsReplicaGetInfo2, FILETIME