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
);

parameters

[in] hDs

包含从 DSBind 或 DSBindWithCred 函数获取的目录服务句柄。

[in] ServerDN

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

[in, optional] DomainDN

指向以 null 结尾的字符串的指针，该字符串指定由 ServerDN 托管的域。 如果此参数为 NULL，则不执行验证以确保 ServerDN 是 DomainDN 中的最后一个域控制器。

[out, optional] fLastDcInDomain

指向布尔值的指针，如果 ServerDN 是 DomainDN 中的最后一个 DC 或 FALSE，则接收 TRUE。 如果 DomainDN 为 NULL，此参数接收 FALSE。

[in] fCommit

包含一个布尔值，该值指定是否应实际删除域控制器。 如果此参数为非零，则删除 ServerDN 。 如果此参数为零，则检查 是否存在 ServerDN 并写入 fLastDcInDomain ，但不会删除域控制器。

返回值

如果成功 ， 则返回ERROR_SUCCESS;如果失败，则返回 Win32 或 RPC 错误代码。 可能的错误代码包括以下内容。

注解

注意

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

要求

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

请参阅

域控制器和复制管理功能

DsBind

DsBindWithCred

DsRemoveDsDomain