Funzione DsReplicaSyncA (ntdsapi.h)

Articolo
08/25/2023

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 costante con terminazione Null 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 di directory di origine (DSA) verifichi che l'istanza DSA locale sia presente nell'elenco di 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

Sincronizza usando un ISM.

DS_REPSYNC_NO_DISCARD

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

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 viene ERROR_SUCCESS.

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

Commenti

Il server su cui viene eseguito DsReplicaSync viene chiamato destinazione. Il contesto di denominazione di destinazione viene aggiornato 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 L'uso forzato della 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ò interrompere una sincronizzazione urgente eseguita per fornire l'accesso a un utente bloccato di recente o per aggiungere una nuova password di trust. Se si chiama spesso questa API, è 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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