DsReplicaSyncAllA 函数 (ntdsapi.h)

DsReplicaSyncAll 函数根据需要使用可传递复制将服务器与所有其他服务器同步。 默认情况下,DsReplicaSyncAll 将服务器与其站点中的所有其他服务器同步;但是,还可以使用它跨站点边界同步。

语法

NTDSAPI DWORD DsReplicaSyncAllA(
  [in]            HANDLE                                  hDS,
  [in]            LPCSTR                                  pszNameContext,
  [in]            ULONG                                   ulFlags,
  [in]            BOOL(* )(LPVOID,PDS_REPSYNCALL_UPDATEA) pFnCallBack,
  [in, optional]  LPVOID                                  pCallbackData,
  [out, optional] PDS_REPSYNCALL_ERRINFOA                 **pErrors
);

参数

[in] hDS

包含从 DSBindDSBindWithCred 函数获取的目录服务句柄。

[in] pszNameContext

指向以 null 结尾的字符串的指针,该字符串指定要同步的命名上下文的可分辨名称。 pszNameContext 参数是可选的;如果其值 NULL,则复制配置命名上下文。

[in] ulFlags

传递用于处理请求的其他数据。 此参数可以是以下值的组合。

DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE

如果无法联系任何服务器,或者由于拓扑断开连接或损坏而无法访问任何服务器,则生成致命错误。

DS_REPSYNCALL_CROSS_SITE_BOUNDARIES

跨站点边界同步。 默认情况下,DsReplicaSyncAll 尝试仅与主系统位于同一站点中的 DC 同步。 设置此标志以尝试与企业林中的所有 DC 同步。 但是,仅当通过同步 (RPC) 传输进行连接时,才能同步 DC。

DS_REPSYNCALL_DO_NOT_SYNC

禁用所有同步。 拓扑仍在分析中,仍可识别不可用或无法访问的服务器。

DS_REPSYNCALL_ID_SERVERS_BY_DN

如果出现非致命错误,则返回服务器可分辨名称(DN),而不是其 GUID DNS 名称。

DS_REPSYNCALL_NO_OPTIONS

此选项不起作用。

DS_REPSYNCALL_PUSH_CHANGES_OUTWARD

使用可传递复制将主服务器中的更改推送到所有合作伙伴。 这将反转复制的方向,以及复制集的执行顺序从通常的“拉取”执行模式。

DS_REPSYNCALL_SKIP_INITIAL_CHECK

假设所有服务器都正在响应。 这会加快 DsReplicaSyncAll 函数的操作速度,但如果某些服务器未响应,可能会阻止某些可传递复制。

DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY

禁用可传递复制。 同步仅与相邻服务器一起执行。

[in] pFnCallBack

指向由 DsReplicaSyncAll 函数调用的应用程序定义的 SyncUpdateProc 函数的指针,启动两个服务器的同步,完成两个服务器的同步,或完成站点中所有服务器的同步。

[in, optional] pCallbackData

指向作为 SyncUpdateProc 回调函数所指向 pFnCallBack 参数所指向的应用程序定义数据的指针。

[out, optional] pErrors

指向的指针的 NULL 终止数组
DS_REPSYNCALL_ERRINFO 包含同步期间发生的错误的结构。 用于保存指针数组和 MsCS\mscs\clusctl_resource_type_get_private_property_fmts.xml 数据的内存被分配为单个内存块,并且当单个 调用 localFree 不再需要时,应释放该内存,该内存中返回的指针值 pErrors 用作参数。

返回值

如果函数成功,则返回值 ERROR_SUCCESS

如果函数失败,则返回值如下所示。

言论

DsReplicaSyncAll 函数在生成要从中同步的拓扑之前尝试绑定到所有服务器。 如果无法联系服务器,该函数将从拓扑中排除该服务器,并尝试解决此问题。 ulFlags 中设置 DS_REPSYNCALL_SKIP_INITIAL_CHECK 标志 会绕过初始绑定。

如果无法联系服务器,则 DsReplicaSyncAll 函数会尝试围绕服务器进行路由并从尽可能多的服务器进行复制,除非 DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE 设置为 ulFlags

DsReplicaSyncAll 函数可以使用由 pFnCallBack 指向的回调函数来让最终用户了解复制的当前状态。 DsReplicaSyncAll 函数的执行在调用由 pFnCallBack指向的函数时暂停。 如果回调函数的返回值 TRUE,则复制将继续;否则,DsReplicaSyncAll 函数将终止复制。

注意

ntdsapi.h 标头将 DsReplicaSyncAll 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2008
目标平台 窗户
标头 ntdsapi.h
Ntdsapi.lib
DLL Ntdsapi.dll

另请参阅

DS_REPSYNCALL_ERRINFO

DS_REPSYNCALL_UPDATE

域控制器和复制管理功能

DsReplicaSync

SyncUpdateProc