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