DsReplicaModifyA 函数 （ntdsapi.h）
DsReplicaModify 函数修改目标命名上下文的现有复制源引用。
语法
NTDSAPI DWORD DsReplicaModifyA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] const UUID *pUuidSourceDsa,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD ReplicaFlags,
[in] DWORD ModifyFields,
[in] DWORD Options
);
参数
[in] hDS
包含从 DSBind 或 DSBindWithCred 函数获取的目录服务句柄。
[in] NameContext
指向常量以 null 结尾的字符串的指针，该字符串指定目标命名上下文（NC）的可分辨名称（DN）。
[in] pUuidSourceDsa
指向源目录系统代理 （DSA） 的 UUID 的指针。 如果 modifyFields 不包含
[in] TransportDn
保留以供将来使用。 除 NULL 以外的任何值 都会导致返回 ERROR_NOT_SUPPORTED。
[in] SourceDsaAddress
指向常量以 null 结尾的 Unicode 字符串的指针，该字符串指定源 DSA 的传输特定地址。 如果 pUuidSourceDsa 不 NULL，并且 ModifyFields 不包含 DS_REPMOD_UPDATE_ADDRESS，则忽略此参数。
[in] pSchedule
指向包含复制源复制计划数据的 SCHEDULE 结构的指针。 此参数是可选的，如果未使用，则可以 NULL。 如果 ModifyFields 包含 DS_REPMOD_UPDATE_SCHEDULE 标志，则此参数是必需的。
[in] ReplicaFlags
此参数用于控制复制行为，可采用以下值。
DS_REPL_NBR_SYNC_ON_STARTUP
启动目标服务器时，会尝试从此源复制此命名上下文。 这通常仅适用于站点内邻居。
DS_REPL_NBR_DO_SCHEDULED_SYNCS
按计划执行复制。 通常设置此标志，除非此命名上下文的计划和源为“永不”，即空计划。
DS_REPL_NBR_TWO_WAY_SYNC
如果设置，则指示入站复制完成后，目标服务器必须告知源服务器以相反方向同步。 此功能用于拨号方案，其中只有两个服务器之一可以启动拨号连接。 例如，此选项将用于公司总部和分支机构，其中分支机构通过 Internet 通过拨号 ISP 连接连接到公司总部。
DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
此邻居设置为禁用基于通知的同步。 在站点中，域控制器根据发生更改时的通知相互同步。 此设置可防止此邻居执行由通知触发的同步。 邻居仍会根据其计划或响应手动请求的同步执行同步。
DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
此邻居设置为不根据其计划执行同步。 此邻居执行同步的唯一方法是响应更改通知或手动请求的同步。
DS_REPL_NBR_COMPRESS_CHANGES
将从此源收到的更改进行压缩。 如果源服务器位于其他站点中，则通常设置此设置。
DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
不应从此源接收任何更改通知。 如果源服务器位于其他站点中，则通常设置此设置。
[in] ModifyFields
指定应修改哪些字段。 必须在 modifyFields
DS_REPMOD_UPDATE_ADDRESS
更新与引用的服务器关联的地址。
DS_REPMOD_UPDATE_FLAGS
更新与副本关联的标志。
DS_REPMOD_UPDATE_RESULT
未使用。 目前不支持指定结果值的更新。 结果值默认为 0。
DS_REPMOD_UPDATE_SCHEDULE
更新与副本关联的定期复制计划。
DS_REPMOD_UPDATE_TRANSPORT
更新与副本关联的传输。
[in] Options
传递用于处理请求的其他数据。 此参数可以是以下值的组合。
DS_REPMOD_ASYNCHRONOUS_OPERATION
异步执行此操作。
DS_REPMOD_WRITEABLE
指示可以写入要修改的副本。
返回值
如果函数成功，则返回值 ERROR_SUCCESS。
如果函数失败，则返回值可以是下列值之一。
言论
注意
ntdsapi.h 标头将 DsReplicaModify 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2008 |
| 目标平台 | 窗户 |
| 标头 | ntdsapi.h |
| 库 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |