DS_REPL_KCC_DSA_FAILUREW_BLOB structure

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

Examples

The following code example shows 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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Ntdsapi.h

See also

DS_REPL_KCC_DSA_FAILURE
FILETIME
Lightweight Directory Access Protocol API

 

 

Show: