DnsModifyRecordsInSet_UTF8 函数 (windns.h)

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

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

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

语法

DNS_STATUS DnsModifyRecordsInSet_UTF8(
  [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

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

[in, optional] pDeleteRecords

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

[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_RECORDpName 成员的值必须相同,否则调用将失败。 如果 pAddRecords 中指定的记录已存在,则不会发生任何更改。

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

要求

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

另请参阅

DNS_RECORD

DnsQuery

DnsReplaceRecordSet