DsReplicaConsistencyCheck-Funktion (ntdsapi.h)

Artikel
02/29/2024

Die DsReplicaConsistencyCheck-Funktion ruft den Knowledge Consistency Checker (KCC) auf, um die Replikationstopologie zu überprüfen. Der KCC passt die Datenreplikationstopologie Ihres Netzwerks dynamisch an, wenn Domänencontroller dem Netzwerk hinzugefügt oder aus diesem entfernt werden, wenn ein Domänencontroller nicht verfügbar ist oder wenn die Datenreplikationszeitpläne geändert werden.

Syntax

NTDSAPI DWORD DsReplicaConsistencyCheck(
  [in] HANDLE        hDS,
  [in] DS_KCC_TASKID TaskID,
  [in] DWORD         dwFlags
);

Parameter

[in] hDS

Enthält ein Verzeichnisdiensthandle, das von der DSBind-, DSBindWithCred- oder DsBindWithSpn-Funktion abgerufen wurde.

[in] TaskID

Gibt die Aufgabe an, die vom KCC ausgeführt werden soll. DS_KCC_TASKID_UPDATE_TOPOLOGY ist der einzige derzeit unterstützte Wert.

[in] dwFlags

Enthält eine Reihe von Flags, die das Funktionsverhalten ändern. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DS_KCC_FLAG_ASYNC_OP

Die Aufgabe wird in die Warteschlange gestellt, und dann wird die Funktion zurückgegeben, ohne auf den Abschluss der Aufgabe zu warten.

DS_KCC_FLAG_DAMPED

Die Aufgabe wird der Warteschlange nicht hinzugefügt, wenn bald eine andere Aufgabe in der Warteschlange ausgeführt wird.

Rückgabewert

Wenn die Funktion ihren Vorgang erfolgreich ausführt, wird der Rückgabewert ERROR_SUCCESS. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	ntdsapi.h
Bibliothek	Ntdsapi.lib
DLL	Ntdsapi.dll