Funzione DsReplicaSyncA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsReplicaSync sincronizza un contesto di denominazione di destinazione con una delle relative origini.

Sintassi

NTDSAPI DWORD DsReplicaSyncA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] const UUID *pUuidDsaSrc,
  [in] ULONG      Options
);

Parametri

[in] hDS

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

[in] NameContext

Puntatore a una stringa con terminazione Null costante che specifica il nome distinto del controller di rete di destinazione.

[in] pUuidDsaSrc

Puntatore all'UUID di un'origine che esegue la replica nel controller di rete di destinazione.

[in] Options

Passa dati aggiuntivi usati per elaborare la richiesta. Questo parametro può essere una combinazione dei valori seguenti.

DS_REPSYNC_ADD_REFERENCE

Fa in modo che l'agente del sistema directory di origine (DSA) verifichi che l'agente DSA locale sia presente nell'elenco replica di origine. In caso contrario, viene aggiunto il DSA locale. Ciò garantisce che l'origine invii notifiche di modifica.

DS_REPSYNC_ALL_SOURCES

Questo valore non è supportato.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista e Windows Server 2003: Sincronizza da tutte le origini.

DS_REPSYNC_ASYNCHRONOUS_OPERATION

Esegue questa operazione in modo asincrono.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista e Windows Server 2003: Obbligatorio quando si usa DS_REPSYNC_ALL_SOURCES.

DS_REPSYNC_FORCE

Sincronizza anche se il collegamento è attualmente disabilitato.

DS_REPSYNC_FULL

Sincronizza a partire dal primo numero di sequenza di aggiornamento (USN).

DS_REPSYNC_INTERSITE_MESSAGING

Esegue la sincronizzazione con un ISM.

DS_REPSYNC_NO_DISCARD

Non rimuove questa richiesta di sincronizzazione, anche se è in sospeso una sincronizzazione simile.

DS_REPSYNC_PERIODIC

Indica che questa operazione è una richiesta di sincronizzazione periodica pianificata dall'amministratore.

DS_REPSYNC_URGENT

Indica che questa operazione è una notifica di un aggiornamento contrassegnato come urgente.

DS_REPSYNC_WRITEABLE

La replica è scrivibile. In caso contrario, è di sola lettura.

Valore restituito

Se la funzione esegue correttamente l'operazione, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno degli errori standard dell'API Win32.

Osservazioni

Il server su cui viene eseguito DsReplicaSync viene chiamato destinazione. Il contesto di denominazione di destinazione viene portato up-to-date rispetto a un sistema di origine, identificato dall'UUID dell'oggetto NTDS Settings del sistema di origine. Il sistema di destinazione deve essere già configurato in modo che il sistema di origine sia uno dei sistemi da cui riceve i dati di replica.

Nota Forzare la sincronizzazione manuale può impedire al servizio directory di assegnare correttamente la priorità alle operazioni di replica. Ad esempio, la sincronizzazione di un nuovo utente può impedire una sincronizzazione urgente eseguita per fornire l'accesso a un utente bloccato di recente o per aggiungere una nuova password di attendibilità. Se si chiama questa API spesso, è possibile inondare la rete con le richieste, che possono interferire con altre operazioni di replica. Per questo motivo, è consigliabile usare questa funzione solo per scenari a uso singolo anziché incorporarla in un'applicazione che la userebbe regolarmente.

Nota

L'intestazione ntdsapi.h definisce DsReplicaSync come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	ntdsapi.h
libreria	Ntdsapi.lib
dll	Ntdsapi.dll