DsReplicaDelA 函数 (ntdsapi.h)

DsReplicaDel 函数从目标命名上下文(NC)中删除复制源引用。

语法

NTDSAPI DWORD DsReplicaDelA(
  [in] HANDLE hDS,
  [in] LPCSTR NameContext,
  [in] LPCSTR DsaSrc,
  [in] ULONG  Options
);

参数

[in] hDS

包含从 DSBindDSBindWithCred 函数获取的目录服务句柄。

[in] NameContext

指向常量以 null 结尾的字符串的指针,该字符串指定要从中删除副本的目标 NC 的可分辨名称(DN)。 目标 NC 记录必须以对象、实例化或未实例化或引用幻影的形式存在,例如,具有 GUID 的幻影。

[in] DsaSrc

指向常量以 null 结尾的 Unicode 字符串的指针,该字符串指定源目录系统代理(DSA)的传输特定地址。 此源服务器由字符串名称标识,而不是由其 UUID标识。 适用于 DsaSrc 的字符串名称通常是基于 GUID的 DNS 名称,其中名称 GUID 部分是源服务器的 nTDSDSA 对象的 GUID

[in] Options

传递用于处理请求的其他数据。 此参数可以是以下值的组合。

DS_REPDEL_ASYNCHRONOUS_OPERATION

异步执行此操作。

DS_REPDEL_IGNORE_ERRORS

忽略从与源联系生成的任何错误,以指示其从其复制到的服务器列表中删除此 NC。

DS_REPDEL_INTERSITE_MESSAGING

表示副本基于邮件,而不是使用本机目录服务 RPC 进行同步。

DS_REPDEL_LOCAL_ONLY

不与源联系,告知其从其复制到的服务器列表中删除此 NC。 如果未设置此标志,并且链接基于 RPC,则会联系源。

DS_REPDEL_NO_SOURCE

删除 NC 中的所有对象。 此选项仅适用于没有源的只读 NC。

DS_REPDEL_REF_OK

允许删除只读副本,即使它源其他只读副本也是如此。

DS_REPDEL_WRITEABLE

表示可以写入已删除的副本。

返回值

如果函数成功,则返回值 ERROR_SUCCESS

如果函数失败,则返回值为标准 Win32 API 错误,或者如果参数无效,则 ERROR_INVALID_PARAMETER

言论

注意

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

要求

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

另请参阅

域控制器和复制管理功能

DsReplicaAdd

DsReplicaModify

DsReplicaSync

DsReplicaUpdateRefs