DsReplicaUpdateRefsA 函数 （ntdsapi.h）
DsReplicaUpdateRefs 函数从源命名上下文添加或删除目标复制引用。
语法
NTDSAPI DWORD DsReplicaUpdateRefsA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR DsaDest,
[in] const UUID *pUuidDsaDest,
[in] ULONG Options
);
参数
[in] hDS
包含从 DSBind 或 DSBindWithCred 函数获取的目录服务句柄。
[in] NameContext
指向常量以 null 结尾的字符串的指针，该字符串指定源命名上下文的可分辨名称。
[in] DsaDest
指向常量以 null 结尾的字符串的指针，该字符串指定目标目录系统代理的传输特定地址。
[in] pUuidDsaDest
指向包含目标目录系统代理的 UUID 值的指针。
[in] Options
包含一组标志，这些标志提供用于处理请求的其他数据。 这可以是零，也可以是以下一个或多个值的组合。
DS_REPUPD_ADD_REFERENCE
对目标的引用将添加到源服务器。
DS_REPUPD_ASYNCHRONOUS_OPERATION
此操作以异步方式执行。
DS_REPUPD_DELETE_REFERENCE
从源服务器中删除对目标的引用。
DS_REPUPD_WRITEABLE
添加或删除的副本的引用是可写的。 否则，它是只读的。
返回值
如果函数成功，则返回 ERROR_SUCCESS。
如果函数失败，则返回值可以是下列值之一。
言论
如果在 Options 参数中同时设置 DS_REPUPD_ADD_REFERENCE 和 DS_REPUPD_DELETE_REFERENCE，则在服务器上不存在目标时会添加对目标的引用。 如果已存在对目标的引用，则会更新引用。
注意
ntdsapi.h 标头将 DsReplicaUpdateRefs 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista |
| 支持的最低服务器 | Windows Server 2008 |
| 目标平台 | 窗户 |
| 标头 | ntdsapi.h |
| 库 | Ntdsapi.lib |
| DLL | Ntdsapi.dll |