DsReplicaDelA 函数 (ntdsapi.h)
DsReplicaDel 函数从目标命名上下文(NC)中删除复制源引用。
语法
NTDSAPI DWORD DsReplicaDelA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR DsaSrc,
[in] ULONG Options
);
参数
[in] hDS
包含从 DSBind 或 DSBindWithCred 函数获取的目录服务句柄。
[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 |