DNS_QUERY_REQUEST結構（windns.h）

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 結構中傳回的 pQueryRecord s 所指向的數據格式。 例如，如果 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

用戶內容的指標。

要求

要求	價值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2012 [僅限傳統型應用程式]
標頭	windns.h

另請參閱

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_RESULT

DnsCancelQuery

DnsQuery

DnsQueryEx