DsReplicaSyncA 函数 （ntdsapi.h）
DsReplicaSync 函数将目标命名上下文（NC）与其源之一同步。
语法
NTDSAPI DWORD DsReplicaSyncA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] const UUID *pUuidDsaSrc,
[in] ULONG Options
);
参数
[in] hDS
包含从 DSBind 或 DSBindWithCred 函数获取的目录服务句柄。
[in] NameContext
指向指定目标 NC 的可分辨名称的常量以 null 结尾的字符串的指针。
[in] pUuidDsaSrc
指向复制到目标 NC 的源的 UUID 的指针。
[in] Options
传递用于处理请求的其他数据。 此参数可以是以下值的组合。
DS_REPSYNC_ADD_REFERENCE
使源目录系统代理 （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 设置对象的 UUID 标识 up-to日期。 必须已配置目标系统，以便源系统是接收复制数据的系统之一。
注意
ntdsapi.h 标头将 DsReplicaSync 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2008 |
| 目标平台 | 窗户 |
| 标头 | ntdsapi.h |
| 库 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |