structure DS_REPL_NEIGHBORW (ntdsapi.h)

La structure de DS_REPL_NEIGHBOR contient des données d’état de réplication entrantes pour un contexte de nommage et une paire de serveurs source particulières, comme retourné par les fonctions DsReplicaGetInfo et DsReplicaGetInfo2 .

Syntaxe

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;

Membres

pszNamingContext

Pointeur vers une chaîne terminée par null qui contient le contexte de nommage auquel se rapportent ces données d’état de réplication. Chaque contexte de nommage est répliqué indépendamment et a des données voisines associées différentes, même si les contextes d’affectation de noms sont répliqués à partir du même serveur source.

pszSourceDsaDN

Pointeur vers une chaîne terminée par null qui contient le nom unique de l’agent de service d’annuaire correspondant au serveur source auquel se rapportent ces données d’état de réplication. Chaque serveur source a des données voisines associées différentes.

pszSourceDsaAddress

Pointeur vers une chaîne terminée par null qui contient l’adresse réseau spécifique au transport du serveur source. Autrement dit, un nom de service de nom d’annuaire pour la réplication RPC/IP ou une adresse SMTP pour une réplication SMTP.

pszAsyncIntersiteTransportDN

Pointeur vers une chaîne terminée par null qui contient le nom unique de l’objet interSiteTransport qui correspond au transport sur lequel la réplication est effectuée. Ce membre contient la valeur NULL pour la réplication RPC/IP.

dwReplicaFlags

Contient un ensemble d’indicateurs qui spécifient des attributs et des options pour les données de réplication. Il peut s’agir de zéro ou d’une combinaison d’un ou plusieurs des indicateurs suivants.

DS_REPL_NBR_WRITEABLE (16 (0x10))

La copie locale du contexte de nommage est accessible en écriture.

DS_REPL_NBR_SYNC_ON_STARTUP (32 (0x20))

La réplication de ce contexte de nommage à partir de cette source est tentée lorsque le serveur de destination est démarré. Cela ne s'applique normalement qu'aux voisins intra-sites.

DS_REPL_NBR_DO_SCHEDULED_SYNCS (64 (0x40))

Exécuter la réplication selon une planification. Cet indicateur est normalement défini, sauf si la planification de ce contexte/source de nommage est « jamais », c’est-à-dire la planification vide.

DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT (128 (0x80))

Exécuter la réplication indirectement par le biais du service de messagerie inter-sites. Cet indicateur est défini uniquement lors de la réplication sur SMTP. Cet indicateur n'est pas défini lors de la réplication sur RPC/IP inter-site.

DS_REPL_NBR_TWO_WAY_SYNC (512 (0x200))

Si la valeur est définie, indique que lorsque la réplication entrante est terminée, le serveur de destination doit indiquer au serveur source de se synchroniser dans le sens inverse. Cette fonctionnalité est utilisée dans les scénarios d'accès à distance dans lesquels un seul des deux serveurs peut initier une connexion d'accès à distance. Par exemple, cette option serait utilisée dans un siège social d'entreprise et une filiale, où la filiale se connecte au siège social par le biais d'Internet au moyen d'une connexion d'accès à distance de fournisseur de services Internet.

DS_REPL_NBR_RETURN_OBJECT_PARENTS (2048 (0x800))

Ce voisin est dans un état où il retourne les objets parents avant les objets enfants. Il bascule dans cet état après avoir reçu un objet enfant avant son parent.

DS_REPL_NBR_FULL_SYNC_IN_PROGRESS (65536 (0x10000))

Le serveur de destination exécute une synchronisation complète à partir du serveur source. Les synchronisations complètes n’utilisent pas de vecteurs qui créent des mises à jour (DS_REPL_CURSORS) pour filtrer les mises à jour. Les synchronisations complètes ne sont pas utilisées dans le cadre du protocole de réplication normal.

DS_REPL_NBR_FULL_SYNC_NEXT_PACKET (131072 (0x20000))

Le dernier paquet de la source indiquait une modification d’un objet que le serveur de destination n’avait pas encore créé. Le paquet suivant à demander indique au serveur source de placer tous les attributs de l’objet modifié dans le paquet.

DS_REPL_NBR_NEVER_SYNCED (2097152 (0x200000))

Aucune synchronisation n'a jamais été effectuée avec succès à partir de cette source.

DS_REPL_NBR_PREEMPTED (16777216 (0x1000000))

Le moteur de réplication a temporairement arrêté le traitement de ce voisin afin de traiter un autre voisin de priorité supérieure, soit pour cette partition, soit pour une autre partition. Le moteur de réplication reprendra le traitement de ce voisin une fois le travail de priorité plus élevée terminé.

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS (67108864 (0x4000000))

Ce voisin est défini pour désactiver les synchronisations basées sur les notifications. Dans un site, les contrôleurs de domaine se synchronisent les uns avec les autres en fonction des notifications lorsque des modifications se produisent. Ce paramètre empêche ce voisin d'exécuter des synchronisations déclenchées par des notifications. Le voisin effectue toujours des synchronisations en fonction de sa planification ou en réponse aux synchronisations demandées manuellement.

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC (134217728 (0x8000000))

Ce voisin est défini pour ne pas effectuer de synchronisations en fonction de sa planification. La seule façon pour ce voisin d’effectuer des synchronisations consiste à répondre aux notifications de modification ou aux synchronisations demandées manuellement.

DS_REPL_NBR_COMPRESS_CHANGES (268435456 (0x10000000))

Les modifications reçues de cette source doivent être compressées. Cette valeur est normalement définie si, et uniquement si, le serveur source se trouve sur un autre site.

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS (536870912 (0x20000000))

Aucune notification de modification ne doit être reçue à partir de cette source. Définissez normalement si, et uniquement si, le serveur source se trouve dans un autre site.

DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET (1073741824 (0x40000000))

Ce voisin est dans un état où il recrée le contenu de ce réplica à cause d'une modification dans le jeu d'attributs partiel.

dwReserved

Réservé pour un usage futur.

uuidNamingContextObjGuid

Contient l’objetGuid du contexte de nommage correspondant à pszNamingContext.

uuidSourceDsaObjGuid

Contient l’objetGuid de l’objet nTDSDSA correspondant à pszSourceDsaDN.

uuidSourceDsaInvocationID

Contient l’identificateur d’appel utilisé par le serveur source à la dernière tentative de réplication.

uuidAsyncIntersiteTransportObjGuid

Contient l’objetGuid de l’objet de transport intersite correspondant à pszAsyncIntersiteTransportDN.

usnLastObjChangeSynced

Contient le numéro de séquence de mise à jour de la dernière mise à jour d’objet reçue.

usnAttributeFilter

Contient la valeur usnLastObjChangeSynced à la fin du dernier cycle de réplication terminé et réussi, ou 0 si aucun. Les attributs de la source mis à jour pour la dernière fois à un numéro de séquence de mise à jour inférieur ou égal à cette valeur ont déjà été reçus et appliqués par la destination.

ftimeLastSyncSuccess

Contient une structure FILETIME qui contient la date et l’heure d’achèvement du dernier cycle de réplication réussi à partir de cette source. Tous les membres de cette structure sont zéro si le cycle de réplication n’a jamais été terminé.

ftimeLastSyncAttempt

Contient une structure FILETIME qui contient la date et l’heure de la dernière tentative de réplication à partir de cette source. Tous les membres de cette structure sont zéro si la réplication n’a jamais été tentée.

dwLastSyncResult

Contient un code d’erreur associé à la dernière tentative de réplication à partir de cette source. Contient ERROR_SUCCESS si la dernière tentative a réussi.

cNumConsecutiveSyncFailures

Contient le nombre de tentatives de réplication ayant échoué à partir de cette source depuis la dernière tentative de réplication réussie ou depuis l’ajout de la source en tant que voisin, si aucune tentative précédente n’a réussi.

Configuration requise

Voir aussi

DS_REPL_NEIGHBORS

DsReplicaGetInfo

DsReplicaGetInfo2

FILETIME