DsRemoveDsServerA 函数 (ntdsapi.h)
DsRemoveDsServer 函数从目录服务的全局区域中删除目录服务代理(DSA)的所有跟踪。
语法
NTDSAPI DWORD DsRemoveDsServerA(
[in] HANDLE hDs,
[in] LPSTR ServerDN,
[in, optional] LPSTR DomainDN,
[out, optional] BOOL *fLastDcInDomain,
[in] BOOL fCommit
);
参数
[in] hDs
包含从 DSBind 或 DSBindWithCred 函数获取的目录服务句柄。
[in] ServerDN
指向以 null 结尾的字符串的指针,该字符串指定要删除的域控制器的完全限定的可分辨名称。
[in, optional] DomainDN
指向以 null 结尾的字符串的指针,该字符串指定由 ServerDN承载的域。 如果此参数 NULL,则不执行验证以确保 ServerDN 是 DomainDN中的最后一个域控制器。
[out, optional] fLastDcInDomain
如果 ServerDN 是 DomainDN 或 FALSE 中最后一个 DC,则指向接收 true TRUE 的布尔值的指针。 如果 DomainDNNULL,则此参数接收 FALSE。
[in] fCommit
包含一个布尔值,该值指定是否应实际删除域控制器。 如果此参数为非零,则删除 ServerDN。 如果此参数为零,则会检查 ServerDN 是否存在,并写入 fLastDcInDomain,但不会删除域控制器。
返回值
如果成功或 Win32 或 RPC 错误代码失败,则返回 ERROR_SUCCESS。 可能的错误代码包括以下内容。
言论
注意
ntdsapi.h 标头将 DsRemoveDsServer 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
支持的最低服务器 | Windows Server 2008 |
目标平台 | 窗户 |
标头 | ntdsapi.h |
库 | Ntdsapi.lib |
DLL | Ntdsapi.dll |