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 名称的字符串的指针。

注意

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

QueryType

类型： WORD

一个 值，该值表示查询的“资源记录 (RR) DNS 记录类型 ”。 QueryType 确定DNS_QUERY_RESULT结构中返回的 pQueryRecord 指向的数据的格式。 例如，如果 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，则 pCustomServers 必须为 NULL。

注意

pCustomServers 和 pDnsServerList 中的至少一个必须为 NULL。 不支持同时将两者设置为非 NULL 值。

注解

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

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

要求

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

另请参阅