DsReplicaSyncA 函数 (ntdsapi.h)

项目
03/13/2024

DsReplicaSync 函数将目标命名上下文 (NC) 与其源之一同步。

语法

NTDSAPI DWORD DsReplicaSyncA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] const UUID *pUuidDsaSrc,
  [in] ULONG      Options
);

参数

[in] hDS

包含从 DSBind 或 DSBindWithCred 函数获取的目录服务句柄。

[in] NameContext

指向以 null 结尾的常量字符串的指针，该字符串指定目标 NC 的可分辨名称。

[in] pUuidDsaSrc

指向复制到目标 NC 的源的 UUID 的指针。

[in] Options

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

DS_REPSYNC_ADD_REFERENCE

使源目录系统代理 (DSA) 验证本地 DSA 是否存在于源复制列表。否则，将添加本地 DSA。这可确保源发送更改通知。

DS_REPSYNC_ALL_SOURCES

不支持此值。

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista 和 Windows Server 2003： 从所有源同步。

DS_REPSYNC_ASYNCHRONOUS_OPERATION

异步执行此操作。

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista 和 Windows Server 2003： 使用 DS_REPSYNC_ALL_SOURCES 时是必需的。

DS_REPSYNC_FORCE

即使链接当前已禁用，也会同步。

DS_REPSYNC_FULL

从第一个更新序列号 (USN) 开始同步。

DS_REPSYNC_INTERSITE_MESSAGING

使用 ISM 进行同步。

DS_REPSYNC_NO_DISCARD

即使类似的同步处于挂起状态，也不会放弃此同步请求。

DS_REPSYNC_PERIODIC

指示此操作是管理员计划的定期同步请求。

DS_REPSYNC_URGENT

指示此操作是标记为紧急更新的通知。

DS_REPSYNC_WRITEABLE

副本是可写的。否则，它是只读的。

返回值

如果函数成功执行其操作，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值是标准 Win32 API 错误之一。

注解

DsReplicaSync 执行的服务器称为目标服务器。目标命名上下文与源系统有关，由源系统 NTDS Settings 对象的 UUID 标识。必须已配置目标系统，以便源系统是它从中接收复制数据的系统之一。

注意强制手动同步可能会阻止目录服务正确确定复制操作的优先级。例如，同步新用户可能会抢占为最近锁定的用户提供访问权限或添加新信任密码而执行的紧急同步。如果经常调用此 API，则可能会向网络充斥请求，这可能会干扰其他复制操作。出于此原因，强烈建议仅将此函数用于单一用途方案，而不是将其合并到定期使用它的应用程序。

注意

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

要求

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