共用方式為


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 名稱。

注意

如果 QueryNameNULL,則查詢會用於本機計算機名稱。

QueryType

類型:WORD

值,表示查詢的 DNS 記錄類型 資源記錄 (RR)QueryType 會決定在 DNS_QUERY_RESULT 結構中傳回的 pQueryRecord s 所指向的數據格式。 例如,如果 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*

cCustomServers 字段中指定 N 陣列的指標 DNS_CUSTOM_SERVER 物件。

如果 cCustomServers 為 0,pCustomServers 就必須 NULL

注意

至少有一個 pCustomServerspDnsServerList 必須 NULL。 不支援同時將兩者設定為非NULL 值。

言論

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

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

要求

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

另請參閱