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)。
QueryOptions
類型:ULONG64
值,其中包含要用於 DNS 查詢
pDnsServerList
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
注意
至少有一個 pCustomServers 和 pDnsServerList 必須 NULL。 不支援同時將兩者設定為非NULL 值。
言論
pCustomServers 中指定的自定義伺服器, 略過系統設定的 DNS 伺服器。
如果查詢名稱符合 名稱解析原則數據表 (NRPT)中的規則,則會忽略自定義伺服器,而且只會使用 NRPT 規則中的伺服器。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 組建 22000 |
支援的最低伺服器 | Windows 組建 22000 |
標頭 | windns.h |