Share via

DnsModifyRecordsInSet_A 函数 (windns.h)

  • 项目

DnsModifyRecordsInSet 函数添加、修改或删除资源记录 (RR) 集，该集以前可能已注册到 DNS 服务器。

与许多 DNS 函数一样， DnsModifyRecordsInSet 函数类型以多种形式实现，以促进不同的字符编码。 根据涉及的字符编码，使用以下函数之一：

  • ANSI 编码 ) 的 DnsModifyRecordsInSet_A (_A
  • unicode 编码) 的 DnsModifyRecordsInSet_W (_W
  • UTF 8 编码) 的 DnsModifyRecordsInSet_UTF8 (_UTF8

语法

DNS_STATUS DnsModifyRecordsInSet_A(
  [in, optional]      PDNS_RECORD pAddRecords,
  [in, optional]      PDNS_RECORD pDeleteRecords,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hCredentials,
  [in, out, optional] PVOID       pExtraList,
  [in, out, optional] PVOID       pReserved
);

参数

[in, optional] pAddRecords

指向包含要添加到 RR 集的 RU 的DNS_RECORD 结构的指针。

[in, optional] pDeleteRecords

指向 DNS_RECORD 结构的指针，该结构包含要从 RR 集中删除的 RU。

[in] Options

一个 值，该值包含 DNS 更新选项的位图。 选项可以组合，所有选项都替代 DNS_UPDATE_SECURITY_USE_DEFAULT。

[in, optional] hCredentials

特定帐户凭据的句柄。 在需要安全动态更新时使用。 此参数是可选的。

[in, out, optional] pExtraList

此参数保留供将来使用，必须设置为 NULL。

[in, out, optional] pReserved

此参数保留供将来使用，必须设置为 NULL。

返回值

成功完成后返回成功确认。 否则，它将返回 Winerror.h 中定义的相应 DNS 特定错误代码。

注解

DnsModifyRecordsInSet 函数类型在以下步骤中执行。

  1. pDeleteRecords 中指定的记录将被删除。 如果 pDeleteRecords 为空或不包含当前集中存在的记录， 则 DnsModifyRecordsInSet 函数将转到下一步。
  2. 将添加 pAddRecords 中指定的记录。 如果 pAddRecords 为空，则操作完成时不添加任何记录。
若要添加新记录，请在 pDeleteRecords 中不提供任何记录，并提供要添加到 pAddRecords 中的记录。 若要修改记录，请在 pDeleteRecords 中指定正在修改的记录，然后将该记录的修改版本置于 pAddRecords 中来添加该记录。 若要删除记录，请仅指定要删除的记录。 可以在对 DnsModifyRecordsInSet 的单个调用中添加或删除多个记录;但是，每个DNS_RECORD中的 pName 成员的值必须相同，否则调用将失败。 如果 pAddRecords 中指定的记录已存在，则不会发生任何更改。

如果未指定服务器列表，则查询默认名称服务器。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 windns.h
Library Dnsapi.lib
DLL Dnsapi.dll

另请参阅

DNS_RECORD

DnsQuery

DnsReplaceRecordSet