Share via

DsDeregisterDnsHostRecordsA 函数 (dsgetdc.h)

  • 项目

DsDeregisterDnsHostRecords 函数删除 DNS 条目，域控制器注册的 A 记录类型除外。 只有管理员、帐户操作员或服务器操作员才能调用此函数。

语法

DSGETDCAPI DWORD DsDeregisterDnsHostRecordsA(
  [in, optional] LPSTR ServerName,
  [in, optional] LPSTR DnsDomainName,
  [in, optional] GUID  *DomainGuid,
  [in, optional] GUID  *DsaGuid,
  [in]           LPSTR DnsHostName
);

参数

[in, optional] ServerName

以 null 结尾的字符串，指定远程域控制器的名称。 如果正在更新的域控制器上运行调用应用程序，则可以设置为 NULL 。

[in, optional] DnsDomainName

以 null 结尾的字符串，指定域控制器占用的域的 DNS 域名。 不需要将此域作为此域控制器托管的域。 如果 为 NULL，则指定已删除最左侧标签的 DnsHostName 。

[in, optional] DomainGuid

指向域的域 GUID 的指针。 如果 为 NULL，则不会删除 GUID 特定名称。

[in, optional] DsaGuid

指向要删除的 NTDS-DSA 对象的 GUID 的指针。 如果 为 NULL，则不会删除 NTDS-DSA 特定名称。

[in] DnsHostName

指向以 null 结尾的字符串的指针，该字符串指定要删除其 DNS 记录的域控制器的 DNS 主机名。

返回值

此函数返回 DSGETDCAPI DWORD。

注解

此函数仅取消注册 SRV 和 CNAME 记录。 它使 A 类型记录保持不变。 删除特定于网站的记录，例如，_ldap。Tcp。<SiteName>._sites.dc._msdcs。<在本示例中，<) 执行函数的域控制器企业中的每个站点 (SiteName> 尝试 DnsDomainName>。 因此，此函数调用可能会创建耗时的运行，并可能为具有多个站点的企业生成大量网络流量。

注意

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

要求

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

另请参阅

DsGetDcSiteCoverage

DsGetSiteName