DNS_QUERY_REQUEST结构（windns.h）

项目
11/08/2024

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 确定 pQueryRecords 在 DNS_QUERY_RESULT 结构中返回的数据的格式。例如，如果 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返回异步查询的结果。

Note If NULL， DnsQueryEx 同步调用。

pQueryContext

指向用户上下文的指针。