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

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

[in] ServerDN

指向以 null 结尾的字符串的指针,该字符串指定要删除的域控制器的完全限定的可分辨名称。

[in, optional] DomainDN

指向以 null 结尾的字符串的指针,该字符串指定由 ServerDN承载的域。 如果此参数 NULL,则不执行验证以确保 ServerDNDomainDN中的最后一个域控制器。

[out, optional] fLastDcInDomain

如果 ServerDNDomainDNFALSE 中最后一个 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

另请参阅

域控制器和复制管理功能

DsBind

DsBindWithCred

DsRemoveDsDomain