通过

DNS_QUERY_REQUEST3结构（windns.h）

  • 项目

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

语法

typedef struct _DNS_QUERY_REQUEST3 {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
  BOOL                          IsNetworkQueryRequired;
  DWORD                         RequiredNetworkIndex;
  DWORD                         cCustomServers;
  DNS_CUSTOM_SERVER             *pCustomServers;
} DNS_QUERY_REQUEST3, *PDNS_QUERY_REQUEST3;

成员

Version

类型：ULONG

结构版本必须是 DNS_QUERY_REQUEST_VERSION3;其值为 3。

QueryName

类型：PCWSTR

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

注意

如果 QueryNameNULL，则查询是本地计算机名称。

QueryType

类型：WORD

一个值，表示查询的 DNS 记录类型 资源记录（RR）。 QueryType 确定 pQueryRecords 在 DNS_QUERY_RESULT 结构中返回的数据的格式。 例如，如果 wType 的值 DNS_TYPE_A，则 pQueryRecords 指向的数据格式 DNS_A_DATA。

QueryOptions

类型：ULONG64

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

pDnsServerList

类型：PDNS_ADDR_ARRAY

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

InterfaceIndex

类型：ULONG

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

pQueryCompletionCallback

类型：PDNS_QUERY_COMPLETION_ROUTINE

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

注意

如果 NULL，则同步调用 DnsQueryEx。

pQueryContext

类型：PVOID

指向用户上下文的指针。

IsNetworkQueryRequired

类型：BOOL

保留。

RequiredNetworkIndex

类型：DWORD

保留。

cCustomServers

类型：DWORD

pCustomServers 成员指向的自定义服务器数。

pCustomServers

类型：_Field_size_（cCustomServers） DNS_CUSTOM_SERVER*

指向 N 数组的指针（其中 n 在 cCustomServers 字段中提供）DNS_CUSTOM_SERVER 对象。

如果 cCustomServers 为 0，则必须 NULLpCustomServers。

注意

至少有一个 pCustomServers，pDnsServerList 必须 NULL。 不支持同时设置为非NULL 值。

言论

pCustomServers 中指定的自定义服务器 绕过系统配置的 DNS 服务器。

如果查询名称与 名称解析策略表 （NRPT）中的规则匹配，则忽略自定义服务器，并且仅使用 NRPT 规则中的服务器。

要求

要求 价值
最低支持的客户端 Windows 内部版本 22000
支持的最低服务器 Windows 内部版本 22000
标头 windns.h

另请参阅