DsReplicaAddA 函数 (ntdsapi.h)

项目
02/29/2024

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 结尾的字符串，指定要为其添加副本 (replica) 的目标命名上下文 (NC) 的可分辨名称 (DN) 。目标 NC 记录必须作为对象（实例化或不实例化）或引用虚拟（例如，具有 GUID 的虚拟）在本地存在。

[in] SourceDsaDn

以 null 结尾的字符串，指定源目录系统代理 NTDS-DSA 对象的 DN。如果 Options 包含 DS_REPADD_ASYNCHRONOUS_REPLICA，则此参数是必需的;否则，将忽略它。

[in] TransportDn

以 null 结尾的字符串，指定表示用于与源服务器通信的 interSiteTransport 对象的 DN。如果 Options 包含 DS_REPADD_INTERSITE_MESSAGING，则此参数是必需的;否则，将忽略它。

[in] SourceDsaAddress

以 null 结尾的字符串，指定源 DSA 的特定于传输的地址。此源服务器由字符串名称标识，而不是由其 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

创建可写副本 (replica) ;否则，副本 (replica) 为只读。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值可以是以下值之一。

注解

注意

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

要求

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