Funzione DsReplicaConsistencyCheck (ntdsapi.h)

Articolo
03/13/2024

La funzione DsReplicaConsistencyCheck richiama il controllo della coerenza della conoscenza (KCC) per verificare la topologia di replica. KCC regola dinamicamente la topologia di replica dei dati della rete quando i controller di dominio vengono aggiunti o rimossi dalla rete, quando un controller di dominio non è disponibile o quando vengono modificate le pianificazioni della replica dei dati.

Sintassi

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

Parametri

[in] hDS

Contiene un handle del servizio directory ottenuto dalla funzione DSBind, DSBindWithCred o DsBindWithSpn.

[in] TaskID

Identifica l'attività che deve essere eseguita dalla KCC. DS_KCC_TASKID_UPDATE_TOPOLOGY è l'unico valore attualmente supportato.

[in] dwFlags

Contiene un set di flag che modificano il comportamento della funzione. Questo può essere zero o una combinazione di uno o più dei valori seguenti.

DS_KCC_FLAG_ASYNC_OP

L'attività viene accodata e quindi la funzione restituisce senza attendere il completamento dell'attività.

DS_KCC_FLAG_DAMPED

L'attività non verrà aggiunta alla coda se verrà eseguita presto un'altra attività in coda.

Valore restituito

Se la funzione esegue correttamente l'operazione, il valore restituito è ERROR_SUCCESS. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	ntdsapi.h
Libreria	Ntdsapi.lib
DLL	Ntdsapi.dll