DsReplicaAddA 函数 （ntdsapi.h）
DsReplicaAdd 函数向目标命名上下文添加复制源引用。
语法
NTDSAPI DWORD DsReplicaAddA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR SourceDsaDn,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD Options
);
参数
[in] hDS
包含从 DSBind 或 DSBindWithCred 函数获取的目录服务句柄。
[in] NameContext
以 null 结尾的字符串，指定要为其添加副本的目标命名上下文（NC）的可分辨名称（DN）。 目标 NC 记录必须以对象、实例化或未实例化或引用幻影的形式存在，例如，具有 GUID 的幻影。
[in] SourceDsaDn
以 null 结尾的字符串，指定源目录系统代理的 NTDS-DSA 对象的 DN。 如果 选项 包括 DS_REPADD_ASYNCHRONOUS_REPLICA，则需要此参数;否则，将忽略它。
[in] TransportDn
以 null 结尾的字符串，该字符串指定 interSiteTransport 对象的 DN，该对象表示用于与源服务器的通信。 如果 选项 包括 DS_REPADD_INTERSITE_MESSAGING，则此参数是必需的;否则，将忽略它。
[in] SourceDsaAddress
指定源 DSA 的传输特定地址的 null 终止字符串。 此源服务器由字符串名称（而不是其 UUID）标识。 适用于 SourceDsaAddress 的字符串名称通常是基于 GUID 的 DNS 名称，其中名称的 GUID 部分是源服务器的 NTDS-DSA 对象的 GUID。
[in] pSchedule
指向包含复制源复制计划数据的 SCHEDULE 结构的指针。 此参数是可选的，如果未使用，则可以 NULL。
[in] Options
传递用于处理请求的其他数据。 此参数可以是以下值的组合。
DS_REPADD_ASYNCHRONOUS_OPERATION
异步执行此操作。
DS_REPADD_ASYNCHRONOUS_REPLICA
不复制 NC。 相反，保存足够的状态数据，以便以后可以复制它。
DS_REPADD_DISABLE_NOTIFICATION
禁用来自此源的 NC 的基于通知的同步。 这应为临时状态。 使用 DS_REPADD_NEVER_NOTIFY 永久禁用同步。
DS_REPADD_DISABLE_PERIODIC
禁用来自此源的 NC 的定期同步。
DS_REPADD_INITIAL
启动 DSA 时，从此源同步 NC。
DS_REPADD_INTERSITE_MESSAGING
使用站点间消息服务（IMS）传输（例如，通过 SMTP 而不是使用本机目录服务 RPC）从源 DSA 同步。
DS_REPADD_NEVER_NOTIFY
禁用来自此源的更改通知。 设置此标志时，源不会在发生更改时通知目标。 对于可能通过 WAN 链接进行的所有站点间复制，建议这样做。
这应为永久状态;使用 DS_REPADD_DISABLE_NOTIFICATION 暂时禁用通知。
DS_REPADD_PERIODIC
按照 pSchedule中定义，定期同步来自此源的 NC。
DS_REPADD_USE_COMPRESSION
复制时使用压缩。 这会节省网络带宽，代价是源服务器和目标服务器的 CPU 开销。
DS_REPADD_WRITEABLE
创建可写副本;否则，副本为只读。
返回值
如果函数成功，则返回值 ERROR_SUCCESS。
如果函数失败，则返回值可以是下列值之一。
言论
注意
ntdsapi.h 标头将 DsReplicaAdd 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2008 |
| 目标平台 | 窗户 |
| 标头 | ntdsapi.h |
| 库 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |