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 |