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。

注意

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

言論

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

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

要求

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

另請參閱

  • 上次更新時間：