DNS_QUERY_RESULT 结构 (windns.h)

DNS_QUERY_RESULT 结构包含从对 DnsQueryEx 的调用返回的 DNS 查询结果。

语法

typedef struct _DNS_QUERY_RESULT {
  ULONG       Version;
  DNS_STATUS  QueryStatus;
  ULONG64     QueryOptions;
  PDNS_RECORD pQueryRecords;
  PVOID       Reserved;
} DNS_QUERY_RESULT, *PDNS_QUERY_RESULT;

成员

Version

结构版本必须是以下版本之一:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

DnsQueryEx 的调用的返回状态。

如果查询以异步方式完成,并且此结构直接从 DnsQueryEx 返回, 则 QueryStatus 包含 DNS_REQUEST_PENDING

如果查询是同步完成的,或者此结构是由 DNS_QUERY_COMPLETION_ROUTINE DNS 回调返回的, 则 QueryStatus 将包含ERROR_SUCCESS(如果成功),或者包含 Winerror.h 中定义的相应 DNS 特定错误代码。

QueryOptions

一个 值,该值包含 DNS 查询中使用的 DNS 查询选项 的位图。 选项可以组合使用,所有选项都替代 DNS_QUERY_STANDARD

pQueryRecords

指向 DNS_RECORD 结构的指针。

如果查询以异步方式完成,并且此结构直接从 DnsQueryEx 返回, 则 pQueryRecords 为 NULL。

如果查询是同步完成的,或者此结构是由 DNS_QUERY_COMPLETION_ROUTINE DNS 回调返回的, 则 pQueryRecords 包含构成响应的资源记录 (RR) 的列表。

注意 应用程序必须使用 DnsRecordListFree 函数释放返回的 RR 集。
 

Reserved

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
标头 windns.h

另请参阅

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST