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

值,表示查詢的 RESOURCE Record (RR) DNS 記錄類型QueryType會決定在 DNS_QUERY_RESULT結構中傳回的 pQueryRecords所指向的資料格式。 例如,如果 wType 的值 DNS_TYPE_ApQueryRecords 所指向的資料格式會 DNS_A_DATA

QueryOptions

值,其中包含 DNS 查詢中使用的 DNS 查詢選項 點陣圖。 選項可以合併,且所有選項都會覆寫 DNS_QUERY_STANDARD

pDnsServerList

DNS_ADDR_ARRAY結構的指標,其中包含要用於查詢的 DNS 伺服器清單。

InterfaceIndex

值,其中包含用來傳送查詢的介面索引。 如果 InterfaceIndex 為 0,則會考慮所有介面。

pQueryCompletionCallback

DNS_QUERY_COMPLETION_ROUTINE回呼的指標,用來從對DnsQueryEx的呼叫傳回非同步查詢的結果。

注意 如果為 Null,則會以同步方式呼叫 DnsQueryEx
 

pQueryContext

使用者內容的指標。

規格需求

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

另請參閱

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_RESULT

DnsCancelQuery

DnsQuery

DnsQueryEx