DS_REPL_NEIGHBORW 结构 (ntdsapi.h)

  • 项目

DS_REPL_NEIGHBOR 结构包含特定命名上下文和源服务器对的入站复制状态数据，由 DsReplicaGetInfo 和 DsReplicaGetInfo2 函数返回。

语法

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;

成员

pszNamingContext

指向以 null 结尾的字符串的指针，该字符串包含此复制状态数据所相关的命名上下文。 每个命名上下文都是独立复制的，并且具有不同的关联邻居数据，即使命名上下文是从同一源服务器复制的。

pszSourceDsaDN

指向以 null 结尾的字符串的指针，该字符串包含与此复制状态数据相关的源服务器对应的目录服务代理的可分辨名称。 每个源服务器都有不同的关联邻居数据。

pszSourceDsaAddress

指向以 null 结尾的字符串的指针，该字符串包含源服务器的特定于传输的网络地址。 即 RPC/IP 复制的目录名称服务名称，或 SMTP 复制的 SMTP 地址。

pszAsyncIntersiteTransportDN

指向以 null 结尾的字符串的指针，该字符串包含对应于执行复制的传输 的 interSiteTransport 对象的可分辨名称。 此成员包含 RPC/IP 复制的 NULL 。

dwReplicaFlags

包含一组标志，这些标志指定复制数据的属性和选项。 这可以是零，也可以是以下一个或多个标志的组合。

DS_REPL_NBR_WRITEABLE (16 (0x10) )

命名上下文的本地副本是可写的。

DS_REPL_NBR_SYNC_ON_STARTUP (32 (0x20) )

当启动目标服务器时，将尝试从此源复制此命名上下文。 通常，此选项仅适用于站点内的邻居。

DS_REPL_NBR_DO_SCHEDULED_SYNCS (64 (0x40) )

按计划执行复制。 通常设置此标志，除非此命名上下文/源的计划为“永不”，即空计划。

DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT (128 (0x80) )

通过站点间消息服务间接执行复制操作。 仅当通过 SMTP 进行复制时，才设置此标志。 通过站点间 RPC/IP 进行复制时，不设置此标志。

DS_REPL_NBR_TWO_WAY_SYNC (512 (0x200) )

如果设置，则指示入站复制完成后，目标服务器必须告知源服务器反向同步。 此功能在拨号方案中使用。在拨号方案中，只有两个服务器中的一个可以启动拨号连接。 例如，在公司总部和分公司中可以使用此选项，分公司通过拨号 ISP 连接经由 Internet 连接到公司总部。

DS_REPL_NBR_RETURN_OBJECT_PARENTS (2048 (0x800) )

此邻居正处于先返回父对象后返回子对象的状态。 如果此邻居先收到一个子对象后收到这个子对象的父对象，则进入此状态。

DS_REPL_NBR_FULL_SYNC_IN_PROGRESS (65536 (0x10000) )

目标服务器正在执行与源服务器的完全同步。 完全同步不使用创建更新 (DS_REPL_CURSORS) 来筛选更新的向量。 完全同步不作为普通复制协议的一部分来使用。

DS_REPL_NBR_FULL_SYNC_NEXT_PACKET (131072 (0x20000) )

来自源的最后一个数据包指示对目标服务器尚未创建的对象进行了修改。 要请求的下一个数据包指示源服务器将修改的对象的所有属性放入数据包中。

DS_REPL_NBR_NEVER_SYNCED (2097152 (0x200000) )

从此源进行的同步从未成功完成过。

DS_REPL_NBR_PREEMPTED (16777216 (0x1000000) )

复制引擎已暂时停止处理此邻居，以便为此分区或另一个分区提供另一个更高优先级的邻居服务。 完成较高优先级的工作后，复制引擎将继续处理此邻居。

DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS (67108864 (0x4000000) )

此邻居设置为禁用基于通知的同步。 在某个站点内，域控制器在发生更改时根据通知彼此进行同步。 此设置可避免此邻居执行由通知触发的同步操作。 邻居仍将根据其计划或响应手动请求的同步执行同步。

DS_REPL_NBR_DISABLE_SCHEDULED_SYNC (134217728 (0x8000000) )

此邻居设置为不根据其计划执行同步。 此邻居执行同步的唯一方法是响应更改通知或手动请求的同步。

DS_REPL_NBR_COMPRESS_CHANGES (268435456 (0x10000000) )

将从此源收到的更改进行压缩。 通常，仅当源服务器位于其他站点时，才会设置此值。

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS (536870912 (0x20000000) )

不应从此源接收任何更改通知。 通常，仅当源服务器位于其他站点时设置。

DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET (1073741824 (0x40000000) )

因部分特性集内发生更改，此邻居处于正在重新生成此副本内容的状态。

dwReserved

保留供将来使用。

uuidNamingContextObjGuid

包含对应于 pszNamingContext 的命名上下文的 objectGuid。

uuidSourceDsaObjGuid

包含对应于 pszSourceDsaDN 的 nTDSDA 对象的 objectGuid。

uuidSourceDsaInvocationID

包含自上次复制尝试起源服务器使用的调用标识符。

uuidAsyncIntersiteTransportObjGuid

包含对应于 pszAsyncIntersiteTransportDN 的站点间传输对象的 objectGuid。

usnLastObjChangeSynced

包含上次接收的对象更新的更新序列号。

usnAttributeFilter

包含最后一个完整复制周期结束时的 usnLastObjChangeSynced 值，如果没有，则为 0。 目标已接收并应用源中上次更新的更新序列号小于或等于此值的属性。

ftimeLastSyncSuccess

包含 FILETIME 结构，该结构包含从此源完成上次成功复制周期的日期和时间。 如果复制周期从未完成，则此结构的所有成员均为零。

ftimeLastSyncAttempt

包含一个 FILETIME 结构，该结构包含来自此源的上次复制尝试的日期和时间。 如果从未尝试过复制，则此结构的所有成员均为零。

dwLastSyncResult

包含与此源中上次复制尝试关联的错误代码。 包含 ERROR_SUCCESS （如果上次尝试成功）。

cNumConsecutiveSyncFailures

包含自上次成功复制尝试以来从此源失败的复制尝试次数 ，或者，如果之前没有成功尝试，则包含源添加为邻居之后的复制失败次数。

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
标头 ntdsapi.h

另请参阅

DS_REPL_NEIGHBORS

DsReplicaGetInfo

DsReplicaGetInfo2

FILETIME