windns.h) (DNS_QUERY_REQUEST 结构

项目
08/27/2023

DNS_QUERY_REQUEST 结构包含调用 DnsQueryEx 中使用的 DNS 查询参数。

语法

typedef struct _DNS_QUERY_REQUEST {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
} DNS_QUERY_REQUEST, *PDNS_QUERY_REQUEST;

成员

Version

结构版本必须是下列版本之一：

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

指向表示要查询的 DNS 名称的字符串的指针。

注意如果 QueryName 为 NULL，则查询针对本地计算机名称。

QueryType

一个值，该值表示查询的“ DNS 记录类型 ” (RR) 。 QueryType 确定DNS_QUERY_RESULT结构中返回的 pQueryRecords 指向的数据的格式。例如，如果 wType 的值 DNS_TYPE_A，则 pQueryRecords 指向的数据格式 DNS_A_DATA。

QueryOptions

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

pDnsServerList

指向 DNS_ADDR_ARRAY 结构的指针，该结构包含要用于查询的 DNS 服务器列表。

InterfaceIndex

一个值，该值包含发送查询时所基于的接口索引。如果 InterfaceIndex 为 0，则将考虑所有接口。

pQueryCompletionCallback

指向 DNS_QUERY_COMPLETION_ROUTINE 回调的指针，该回调用于从调用 DnsQueryEx 返回异步查询的结果。

注意如果为 NULL，则同步调用 DnsQueryEx 。

pQueryContext

指向用户上下文的指针。