共用方式為

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

值，表示查詢的 RESOURCE Record (RR) DNS 記錄類型 。 QueryType 會決定在 DNS_QUERY_RESULT 結構中傳回的 pQueryRecords 所指向的數據格式。 例如，如果 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 (陣列的指標，其中 cCustomServers 欄位中會提供 N) DNS_CUSTOM_SERVER 物件。

如果 cCustomServers 為 0， 則 pCustomServers 必須是 NULL。

注意

至少有一個 pCustomServers 和 pDnsServerList 必須是 NULL。 不支援同時設定為非 NULL 值。

備註

pCustomServers 中指定的自定義伺服器會略過系統設定的 DNS 伺服器。

如果查詢名稱符合名稱 解析原則數據表 (NRPT) 中的規則，則會忽略自定義伺服器，而且只會使用 NRPT 規則中的伺服器。

規格需求

需求 值
最低支援的用戶端 Windows 組建 22000
最低支援的伺服器 Windows 組建 22000
標頭 windns.h

另請參閱