DsReplicaUpdateRefsA 函数 (ntdsapi.h)

项目
02/29/2024

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

对添加或删除副本 (replica) 的引用是可写的。否则，它是只读的。

返回值

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

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

注解

如果在 Options 参数中同时设置了DS_REPUPD_ADD_REFERENCE和DS_REPUPD_DELETE_REFERENCE，则在服务器上不存在目标引用时，将添加对目标的引用。如果已存在对目标的引用，则更新该引用。

注意

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

要求

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