通过

DnsModifyRecordsInSet_A函数 （windns.h）

  • 项目

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

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

  • DnsModifyRecordsInSet_A（ANSI 编码_A）
  • DnsModifyRecordsInSet_W （Unicode 编码_W）
  • DnsModifyRecordsInSet_UTF8（UTF 8 编码的_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 集的 R 的 DNS_RECORD 结构的指针。

[in, optional] pDeleteRecords

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

[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 [仅限桌面应用]
目标平台 窗户
标头 windns.h
库 Dnsapi.lib
DLL Dnsapi.dll

另请参阅

DNS_RECORD

DnsQuery

DnsReplaceRecordSet