Funzione DsReplicaAddA (ntdsapi.h)

Articolo
11/20/2024

La funzione DsReplicaAdd aggiunge un riferimento all'origine di replica a un contesto di denominazione di destinazione.

Sintassi

NTDSAPI DWORD DsReplicaAddA(
  [in] HANDLE          hDS,
  [in] LPCSTR          NameContext,
  [in] LPCSTR          SourceDsaDn,
  [in] LPCSTR          TransportDn,
  [in] LPCSTR          SourceDsaAddress,
  [in] const PSCHEDULE pSchedule,
  [in] DWORD           Options
);

Parametri

[in] hDS

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

[in] NameContext

Stringa con terminazione Null che specifica il nome distinto (DN) del contesto di denominazione di destinazione (NC) per il quale aggiungere la replica. Il record NC di destinazione deve esistere localmente come oggetto, creata o meno un'istanza o un fantasma di riferimento, ad esempio un fantasma con un GUID.

[in] SourceDsaDn

Stringa con terminazione Null che specifica il nome DN dell'oggetto NTDS-DSA per l'agente di sistema della directory di origine. Questo parametro è obbligatorio se Options include DS_REPADD_ASYNCHRONOUS_REPLICA; in caso contrario, viene ignorato.

[in] TransportDn

Stringa con terminazione Null che specifica il DN del oggetto interSiteTransport che rappresenta il trasporto utilizzato per la comunicazione con il server di origine. Questo parametro è obbligatorio se Opzioni include DS_REPADD_INTERSITE_MESSAGING; in caso contrario, viene ignorato.

[in] SourceDsaAddress

Stringa con terminazione Null che specifica l'indirizzo specifico del trasporto dell'origine DSA. Questo server di origine è identificato da un nome stringa, non dal relativo UUID. Un nome stringa appropriato per SourceDsaAddress è in genere un nome DNS basato su un GUID, dove la parte GUID del nome è il GUID dell'oggetto NTDS-DSA per il server di origine.

[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.

[in] Options

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

DS_REPADD_ASYNCHRONOUS_OPERATION

Esegue questa operazione in modo asincrono.

DS_REPADD_ASYNCHRONOUS_REPLICA

Non replica il controller di rete. Salvare invece dati di stato sufficienti in modo che possano essere replicati in un secondo momento.

DS_REPADD_DISABLE_NOTIFICATION

Disabilita la sincronizzazione basata su notifica per il controller di rete da questa origine. Si prevede che si tratta di uno stato temporaneo. Usare DS_REPADD_NEVER_NOTIFY per disabilitare definitivamente la sincronizzazione.

DS_REPADD_DISABLE_PERIODIC

Disabilita la sincronizzazione periodica per il controller di rete da questa origine.

DS_REPADD_INITIAL

Sincronizza il controller di rete da questa origine all'avvio di DSA.

DS_REPADD_INTERSITE_MESSAGING

Esegue la sincronizzazione dal DSA di origine usando il trasporto del servizio di messaggistica intersito (IMS), ad esempio tramite SMTP, anziché tramite RPC del servizio directory nativo.

DS_REPADD_NEVER_NOTIFY

Disabilita le notifiche di modifica da questa origine. Quando questo flag è impostato, l'origine non invia una notifica alla destinazione quando si verificano modifiche. Questa operazione è consigliata per tutte le repliche tra siti che possono verificarsi tramite collegamenti WAN.

Si prevede che questo sia uno stato permanente; usare DS_REPADD_DISABLE_NOTIFICATION per disabilitare temporaneamente le notifiche.

DS_REPADD_PERIODIC

Sincronizza periodicamente il controller di rete da questa origine, come definito in pSchedule.

DS_REPADD_USE_COMPRESSION

Usa la compressione durante la replica. Ciò consente di risparmiare larghezza di banda di rete a scapito del sovraccarico della CPU sia nei server di origine che in quello di destinazione.

DS_REPADD_WRITEABLE

Crea una replica scrivibile; in caso contrario, la replica è di sola lettura.

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 DsReplicaAdd 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