Fonction DsReplicaConsistencyCheck (ntdsapi.h)

Article
03/04/2024

La fonction DsReplicaConsistencyCheck appelle le vérificateur de cohérence des connaissances (KCC) pour vérifier la topologie de réplication. Le KCC ajuste dynamiquement la topologie de réplication des données de votre réseau lorsque des contrôleurs de domaine sont ajoutés ou supprimés du réseau, lorsqu’un contrôleur de domaine n’est pas disponible ou lorsque les planifications de réplication des données sont modifiées.

Syntaxe

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

Paramètres

[in] hDS

Contient un handle de service d’annuaire obtenu à partir de la fonction DSBind, DSBindWithCred ou DsBindWithSpn .

[in] TaskID

Identifie la tâche que le KCC doit exécuter. DS_KCC_TASKID_UPDATE_TOPOLOGY est la seule valeur actuellement prise en charge.

[in] dwFlags

Contient un ensemble d’indicateurs qui modifient le comportement de la fonction. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DS_KCC_FLAG_ASYNC_OP

La tâche est mise en file d’attente, puis la fonction retourne sans attendre la fin de la tâche.

DS_KCC_FLAG_DAMPED

La tâche n’est pas ajoutée à la file d’attente si une autre tâche mise en file d’attente s’exécute bientôt.

Valeur retournée

Si la fonction effectue son opération avec succès, la valeur de retour est ERROR_SUCCESS. Si la fonction échoue, la valeur de retour peut être l’une des suivantes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	ntdsapi.h
Bibliothèque	Ntdsapi.lib
DLL	Ntdsapi.dll