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
指向以 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 标识。 必须已配置目标系统,以便源系统是它从中接收复制数据的系统之一。
注意
ntdsapi.h 标头将 DsReplicaSync 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | ntdsapi.h |
Library | Ntdsapi.lib |
DLL | Ntdsapi.dll |