Funzione DsReplicaModifyA (ntdsapi.h)
La funzione DsReplicaModify modifica un riferimento all'origine di replica esistente per un contesto di denominazione di destinazione.
Sintassi
NTDSAPI DWORD DsReplicaModifyA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] const UUID *pUuidSourceDsa,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD ReplicaFlags,
[in] DWORD ModifyFields,
[in] DWORD 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 (DN) del contesto di denominazione di destinazione (NC).
[in] pUuidSourceDsa
Puntatore all'UUID dell'agente del sistema di directory di origine (DSA). Questo parametro può essere null se ModifyFields non include DS_REPMOD_UPDATE_ADDRESS e SourceDsaAddress non è NULL.
[in] TransportDn
Riservato per utilizzi futuri. Qualsiasi valore diverso da NULL genera ERROR_NOT_SUPPORTED restituito.
[in] SourceDsaAddress
Puntatore a una stringa Unicode con terminazione null costante che specifica l'indirizzo specifico del trasporto della DSA di origine. Questo parametro viene ignorato se pUuidSourceDsa non è NULL e ModifyFields non include DS_REPMOD_UPDATE_ADDRESS.
[in] pSchedule
Puntatore a una struttura SCHEDULE contenente i dati della pianificazione della replica per l'origine di replica. Questo parametro è facoltativo e può essere NULL se non usato. Questo parametro è obbligatorio se ModifyFields contiene il flag di DS_REPMOD_UPDATE_SCHEDULE .
[in] ReplicaFlags
Questo parametro viene usato per controllare il comportamento della replica e può accettare i valori seguenti.
DS_REPL_NBR_SYNC_ON_STARTUP
La replica di questo contesto di denominazione da questa origine viene tentata quando viene avviato il server di destinazione. Valido in genere solo per gli elementi adiacenti all'interno del sito.
DS_REPL_NBR_DO_SCHEDULED_SYNCS
La replica viene eseguita in base a una pianificazione. Questo flag è in genere impostato a meno che la pianificazione per questo contesto di denominazione e l'origine non sia "mai", ovvero la pianificazione vuota.
DS_REPL_NBR_TWO_WAY_SYNC
Se impostato, indica che quando la replica in ingresso è stata completata, il server di destinazione deve indicare al server di origine di sincronizzare nella direzione inversa. Questa funzionalità viene utilizzata nel caso di connessioni remote, qualora solo uno dei due server sia in grado di inizializzare la connessione. Questa opzione verrebbe ad esempio utilizzata nella sede centrale di una società e in una filiale, se in quest'ultima il collegamento alla sede centrale viene eseguito tramite Internet, utilizzando una connessione remota ISP.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
Questo vicino è impostato per disabilitare la sincronizzazione basata su notifica. All'interno di un sito, la sincronizzazione tra ciascun controller di dominio avviene in base alle notifiche inviate in caso di modifica. Questa impostazione impedisce a questo vicino di eseguire una sincronizzazione attivata da una notifica. Il vicino eseguirà comunque la sincronizzazione in base alla pianificazione o in risposta alla sincronizzazione richiesta manualmente.
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
Questo vicino è impostato per non eseguire la sincronizzazione in base alla pianificazione. L'unico modo in cui questo vicino eseguirà la sincronizzazione è in risposta alle notifiche di modifica o alla sincronizzazione richiesta manualmente.
DS_REPL_NBR_COMPRESS_CHANGES
Le modifiche ricevute da questa origine devono essere compresse. Questo valore viene normalmente impostato se e solo se il server di origine si trova in un sito diverso.
DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
Nessuna notifica delle modifiche deve essere ricevuta da questa origine. Questo valore viene normalmente impostato se e solo se il server di origine si trova in un sito diverso.
[in] ModifyFields
Specifica i campi da modificare. È necessario specificare almeno un campo in ModifyFields. Questo parametro può essere una combinazione dei valori seguenti.
DS_REPMOD_UPDATE_ADDRESS
Aggiornamenti l'indirizzo associato al server a cui si fa riferimento.
DS_REPMOD_UPDATE_FLAGS
Aggiornamenti i flag associati alla replica.
DS_REPMOD_UPDATE_RESULT
Non usato. La specifica degli aggiornamenti dei valori dei risultati non è attualmente supportata. Valori dei risultati predefiniti su 0.
DS_REPMOD_UPDATE_SCHEDULE
Aggiornamenti la pianificazione di replica periodica associata alla replica.
DS_REPMOD_UPDATE_TRANSPORT
Aggiornamenti il trasporto associato alla replica.
[in] Options
Passa dati aggiuntivi usati per elaborare la richiesta. Questo parametro può essere una combinazione dei valori seguenti.
DS_REPMOD_ASYNCHRONOUS_OPERATION
Esegue questa operazione in modo asincrono.
DS_REPMOD_WRITEABLE
Indica che la replica da modificare può essere scritta in.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti.
Commenti
Nota
L'intestazione ntdsapi.h definisce DsReplicaModify come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 |
Vedi anche
Funzioni di gestione del controller di dominio e della replica