DS_REPL_NEIGHBORW_BLOB 结构 (ntdsapi.h)

项目
08/25/2023

DS_REPL_NEIGHBORW_BLOB 结构包含特定命名上下文和源服务器对的入站复制状态数据。此结构类似于 DS_REPL_NEIGHBOR 结构，但在获取 msDS-NCReplInboundNeighbors 属性的二进制数据时，可以从轻型目录访问协议 API 函数获取。

语法

typedef struct _DS_REPL_NEIGHBORW_BLOB {
  DWORD    oszNamingContext;
  DWORD    oszSourceDsaDN;
  DWORD    oszSourceDsaAddress;
  DWORD    oszAsyncIntersiteTransportDN;
  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_BLOB;

成员

oszNamingContext

包含从此结构的地址到以 null 结尾的 Unicode 字符串的偏移量（以字节为单位），该字符串包含此复制状态数据所属的命名上下文。每个命名上下文都是独立复制的，并且具有不同的关联邻居数据，即使命名上下文是从同一源服务器复制的。

oszSourceDsaDN

包含从此结构的地址到以 null 结尾的 Unicode 字符串的偏移量（以字节为单位），该字符串包含对应于此复制状态数据所属源服务器的目录服务代理的可分辨名称。每个源服务器都有不同的关联邻居数据。

oszSourceDsaAddress

包含从此结构的地址到包含源服务器特定于传输的网络地址的以 null 结尾的 Unicode 字符串的偏移量（以字节为单位）。即 RPC/IP 复制的目录名称服务名称，或 SMTP 复制的 SMTP 地址。

oszAsyncIntersiteTransportDN

包含从此结构的地址到以 null 结尾的 Unicode 字符串的偏移量（以字节为单位），该字符串包含与执行复制的传输相对应的 interSiteTransport 对象的可分辨名称。此成员包含 RPC/IP 复制的 NULL 。

dwReplicaFlags

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

DS_REPL_NBR_WRITEABLE

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

DS_REPL_NBR_SYNC_ON_STARTUP

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

DS_REPL_NBR_DO_SCHEDULED_SYNCS

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

DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT

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

DS_REPL_NBR_TWO_WAY_SYNC

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

DS_REPL_NBR_FULL_SYNC_IN_PROGRESS

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

DS_REPL_NBR_FULL_SYNC_NEXT_PACKET

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

DS_REPL_NBR_NEVER_SYNCED

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

DS_REPL_NBR_COMPRESS_CHANGES

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

DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS

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

dwReserved

保留供将来使用。

uuidNamingContextObjGuid

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

uuidSourceDsaObjGuid

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

uuidSourceDsaInvocationID

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

uuidAsyncIntersiteTransportObjGuid

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

usnLastObjChangeSynced

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

usnAttributeFilter

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

ftimeLastSyncSuccess

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

ftimeLastSyncAttempt

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

dwLastSyncResult

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

cNumConsecutiveSyncFailures

包含自上次成功复制尝试以来或自将源添加为邻居（如果以前没有成功尝试）以来从此源进行的失败复制尝试次数。

要求

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

另请参阅

DS_REPL_NEIGHBOR

FILETIME

轻型目录访问协议 API

通过