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 |