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 结尾的常量字符串的指针,该字符串指定要从中删除副本 (replica) 的目标 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

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

DS_REPDEL_LOCAL_ONLY

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

DS_REPDEL_NO_SOURCE

删除 NC 中的所有对象。 此选项仅对没有源的只读 NCs 有效。

DS_REPDEL_REF_OK

允许删除只读副本 (replica) 即使它源自其他只读副本也是如此。

DS_REPDEL_WRITEABLE

表示可以写入已删除副本 (replica) 。

返回值

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

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

注解

注意

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

要求

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

另请参阅

域控制器和复制管理功能

DsReplicaAdd

DsReplicaModify

DsReplicaSync

DsReplicaUpdateRefs