Share via

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

クエリが実行されるリソース レコード (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 サーバーの一覧を含む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 の配列へのポインター (ここで、N は cCustomServers フィールドで指定されます)。

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

注意

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

注釈

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

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

要件

要件 値
サポートされている最小のクライアント Windows ビルド 22000
サポートされている最小のサーバー Windows ビルド 22000
Header windns.h

こちらもご覧ください