次の方法で共有

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

クエリされる DNS レコードの種類 リソース レコード (RR) を表す値。 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 サーバーの一覧を含む DNS_ADDR_ARRAY 構造体へのポインター。

InterfaceIndex

型: ULONG

クエリが送信されるインターフェイス インデックスを含む値。 InterfaceIndex が 0 の場合、すべてのインターフェイスが考慮されます。

pQueryCompletionCallback

型: PDNS_QUERY_COMPLETION_ROUTINE

DnsQueryExへの呼び出しから非同期クエリの結果を返すために使用される DNS_QUERY_COMPLETION_ROUTINE コールバックへのポインター。

手記

NULL場合は、DnsQueryEx が同期的に呼び出されます。

pQueryContext

型: PVOID

ユーザー コンテキストへのポインター。

IsNetworkQueryRequired

型: BOOL

引っ込み思案。

RequiredNetworkIndex

型: DWORD

引っ込み思案。

cCustomServers

型: DWORD

pCustomServers メンバーが指すカスタム サーバーの数。

pCustomServers

型: _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

オブジェクトを DNS_CUSTOM_SERVER、N の配列へのポインター (cCustomServers フィールドに N が指定されます)。

cCustomServers が 0 の場合、pCustomServers NULLする必要があります。

手記

少なくとも 1 つの pCustomServers と pDnsServerList 1 つが NULLする必要があります。 両方とも、以外の NULL 値に同時に設定することはサポートされていません。

備考

pCustomServers で指定されたカスタム サーバーは、システムで構成された DNS サーバーをバイパス。

クエリ名が 名前解決ポリシー テーブル (NRPT)のルールと一致する場合、カスタム サーバーは無視され、NRPT ルールのサーバーのみが使用されます。

必要条件

要件 価値
サポートされる最小クライアント Windows ビルド 22000
サポートされる最小サーバー Windows ビルド 22000
ヘッダー windns.h

関連項目