Funzione DsReplicaModifyA (ntdsapi.h)

Articolo
03/09/2024

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