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.
[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 uso futuro. Qualsiasi valore diverso da NULL comporta la restituzione di ERROR_NOT_SUPPORTED.
[in] SourceDsaAddress
Puntatore a una stringa Unicode con terminazione Null costante che specifica l'indirizzo specifico del trasporto dell'origine DSA. Questo parametro viene ignorato se pUuidSourceDsa non è NULL e ModifyFields non include DS_REPMOD_UPDATE_ADDRESS.
[in] pSchedule
Puntatore a una struttura SCHEDULE che contiene i dati di 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 DS_REPMOD_UPDATE_SCHEDULE.
[in] ReplicaFlags
Questo parametro viene usato per controllare il comportamento di 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. Questo vale normalmente solo per i vicini all'interno del sito.
DS_REPL_NBR_DO_SCHEDULED_SYNCS
Eseguire la replica in base a una pianificazione. Questo flag viene 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 al termine della replica in ingresso, il server di destinazione deve indicare al server di origine di eseguire la sincronizzazione nella direzione inversa. Questa funzionalità viene usata negli scenari di connessione remota in cui solo uno dei due server può avviare una connessione remota. Ad esempio, questa opzione verrà usata in una sede centrale aziendale e in una succursale, in cui la succursale si connette alla sede centrale aziendale tramite Internet tramite una connessione ISP remota.
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
Questo elemento adiacente è impostato per disabilitare la sincronizzazione basata su notifica. All'interno di un sito, i controller di dominio vengono sincronizzati tra loro in base alle notifiche in caso di modifiche. Questa impostazione impedisce a questo vicino di eseguire una sincronizzazione attivata da una notifica. L'oggetto adiacente continuerà a eseguire la sincronizzazione in base alla pianificazione o in risposta alla sincronizzazione richiesta manualmente.
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
Questo oggetto adiacente è 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. Questa impostazione viene in genere impostata se e solo se il server di origine si trova in un sito diverso.
DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
Nessuna notifica di modifica deve essere ricevuta da questa origine. Questa impostazione viene in genere impostata 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
Aggiorna l'indirizzo associato al server di riferimento.
DS_REPMOD_UPDATE_FLAGS
Aggiorna i flag associati alla replica.
DS_REPMOD_UPDATE_RESULT
Non utilizzato. La specifica degli aggiornamenti dei valori dei risultati non è attualmente supportata. Per impostazione predefinita, i valori dei risultati sono 0.
DS_REPMOD_UPDATE_SCHEDULE
Aggiorna la pianificazione periodica della replica associata alla replica.
DS_REPMOD_UPDATE_TRANSPORT
Aggiorna 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 in cui viene modificata può essere scritta.
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.
Osservazioni
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 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 |