DS_REPL_NEIGHBORW struttura (ntdsapi.h)

La struttura DS_REPL_NEIGHBOR contiene dati sullo stato della replica in ingresso per una determinata coppia di nomi e server di origine, come restituito dalle funzioni DsReplicaGetInfo e DsReplicaGetInfo2.

Sintassi

typedef struct _DS_REPL_NEIGHBORW {
  LPWSTR   pszNamingContext;
  LPWSTR   pszSourceDsaDN;
  LPWSTR   pszSourceDsaAddress;
  LPWSTR   pszAsyncIntersiteTransportDN;
  DWORD    dwReplicaFlags;
  DWORD    dwReserved;
  UUID     uuidNamingContextObjGuid;
  UUID     uuidSourceDsaObjGuid;
  UUID     uuidSourceDsaInvocationID;
  UUID     uuidAsyncIntersiteTransportObjGuid;
  USN      usnLastObjChangeSynced;
  USN      usnAttributeFilter;
  FILETIME ftimeLastSyncSuccess;
  FILETIME ftimeLastSyncAttempt;
  DWORD    dwLastSyncResult;
  DWORD    cNumConsecutiveSyncFailures;
} DS_REPL_NEIGHBORW;

Members

pszNamingContext

Puntatore a una stringa con terminazione null contenente il contesto di denominazione a cui sono relativi i dati dello stato della replica. Ogni contesto di denominazione viene replicato in modo indipendente e dispone di dati adiacenti diversi, anche se i contesti di denominazione vengono replicati dallo stesso server di origine.

pszSourceDsaDN

Puntatore a una stringa con terminazione null contenente il nome distinto dell'agente del servizio directory corrispondente al server di origine a cui sono relativi i dati dello stato della replica. Ogni server di origine ha dati adiacenti diversi.

pszSourceDsaAddress

Puntatore a una stringa con terminazione null contenente l'indirizzo di rete specifico del trasporto del server di origine. Ovvero un nome del servizio nome directory per la replica RPC/IP o un indirizzo SMTP per una replica SMTP.

pszAsyncIntersiteTransportDN

Puntatore a una stringa con terminazione null contenente il nome distinto dell'oggetto interSiteTransport che corrisponde al trasporto su cui viene eseguita la replica. Questo membro contiene NULL per la replica RPC/IP.

dwReplicaFlags

Contiene un set di flag che specificano attributi e opzioni per i dati di replica. Questo può essere zero o una combinazione di uno o più flag seguenti.

DS_REPL_NBR_WRITEABLE (16 (0x10))

La copia locale del contesto di denominazione è modificabile.

DS_REPL_NBR_SYNC_ON_STARTUP (32 (0x20))

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 (64 (0x40))

La replica viene eseguita in base a una pianificazione. Questo flag è in genere impostato a meno che la pianificazione per questo contesto di denominazione/origine non sia "mai", ovvero la pianificazione vuota.

DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT (128 (0x80))

La replica viene eseguita indirettamente tramite il servizio Messaggistica tra siti (ISM). Questo flag è impostato solo per la replica tramite SMTP. Il flag non è impostato durante la replica tramite RPC/IP tra siti.

DS_REPL_NBR_TWO_WAY_SYNC (512 (0x200))

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_RETURN_OBJECT_PARENTS (2048 (0x800))

L'elemento adiacente restituisce gli oggetti padre prima degli oggetti figlio. Questo stato viene attivato quando l'elemento adiacente riceve un oggetto figlio prima del padre.

DS_REPL_NBR_FULL_SYNC_IN_PROGRESS (65536 (0x10000))

È in corso una sincronizzazione completa del server di destinazione dal server di origine. Le sincronizzazioni complete non usano vettori che creano aggiornamenti (DS_REPL_CURSORS) per filtrare gli aggiornamenti. Le sincronizzazioni complete non sono previste nell'ambito del protocollo di replica standard.

DS_REPL_NBR_FULL_SYNC_NEXT_PACKET (131072 (0x20000))

L'ultimo pacchetto dall'origine ha indicato una modifica di un oggetto che il server di destinazione non è ancora stato creato. Il pacchetto successivo da richiedere indica al server di origine di inserire tutti gli attributi dell'oggetto modificato nel pacchetto.

DS_REPL_NBR_NEVER_SYNCED (2097152 (0x200000))

Non è mai stata completata alcuna operazione di sincronizzazione da questa origine.

DS_REPL_NBR_PREEMPTED (16777216 (0x1000000))

Il motore di replica ha interrotto temporaneamente l'elaborazione di questo vicino per il servizio di un altro vicino con priorità superiore, per questa partizione o per un'altra partizione. L'elaborazione dell'elemento adiacente verrà ripresa dal motore di replica una volta completato il lavoro con priorità più alta.

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS (67108864 (0x4000000))

Questo vicino è impostato per disabilitare le sincronizzazioni basate 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 l'esecuzione da parte dell'elemento adiacente delle sincronizzazioni attivate tramite notifiche. Il vicino eseguirà comunque le sincronizzazioni in base alla pianificazione o in risposta alle sincronizzazioni richieste manualmente.

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC (134217728 (0x8000000))

Questo vicino è impostato su non eseguire sincronizzazioni in base alla pianificazione. L'unico modo in cui questo vicino eseguirà le sincronizzazioni è in risposta alle notifiche di modifica o alle sincronizzazioni richieste manualmente.

DS_REPL_NBR_COMPRESS_CHANGES (268435456 (0x10000000))

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 (536870912 (0x20000000))

Nessuna notifica delle modifiche deve essere ricevuta da questa origine. In genere impostato se e solo se il server di origine si trova in un sito diverso.

DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET (1073741824 (0x40000000))

È in corso la ricompilazione da parte dell'elemento adiacente del contenuto di questa replica, in seguito a una modifica nell'insieme di attributi parziali.

dwReserved

Riservato per utilizzi futuri.

uuidNamingContextObjGuid

Contiene l'oggettoGuid del contesto di denominazione corrispondente a pszNamingContext.

uuidSourceDsaObjGuid

Contiene l'oggettoGuid dell'oggetto nTDSDSA corrispondente a pszSourceDsaDN.

uuidSourceDsaInvocationID

Contiene l'identificatore di chiamata usato dal server di origine come dell'ultimo tentativo di replica.

uuidAsyncIntersiteTransportObjGuid

Contiene l'oggettoGuid dell'oggetto trasporto tra siti corrispondente a pszAsyncIntersiteTransportDN.

usnLastObjChangeSynced

Contiene il numero di sequenza di aggiornamento dell'ultimo aggiornamento dell'oggetto ricevuto.

usnAttributeFilter

Contiene il valore usnLastObjChangeSynced alla fine dell'ultimo ciclo di replica completato, riuscito o 0 se nessuno. Gli attributi dell'ultima versione aggiornati in corrispondenza di un numero di sequenza di aggiornamento minore o uguale a questo valore sono già stati ricevuti e applicati dalla destinazione.

ftimeLastSyncSuccess

Contiene una struttura FILETIME contenente la data e l'ora del completamento dell'ultimo ciclo di replica riuscito da questa origine. Tutti i membri di questa struttura sono zero se il ciclo di replica non è mai stato completato.

ftimeLastSyncAttempt

Contiene una struttura FILETIME contenente la data e l'ora dell'ultimo tentativo di replica da questa origine. Tutti i membri di questa struttura sono zero se la replica non è mai stata tentata.

dwLastSyncResult

Contiene un codice di errore associato all'ultimo tentativo di replica da questa origine. Contiene ERROR_SUCCESS se l'ultimo tentativo ha avuto esito positivo.

cNumConsecutiveSyncFailures

Contiene il numero di tentativi di replica non riusciti dall'origine dall'ultimo tentativo di replica riuscito oppure dal momento che l'origine è stata aggiunta come vicina, se non è stato eseguito alcun tentativo precedente.

Requisiti

Vedi anche

DS_REPL_NEIGHBORS

DsReplicaGetInfo

DsReplicaGetInfo2

FILETIME