Win32 API 日本語リファレンス
ホーム › NetworkManagement.Dns › DNS_QUERY_REQUEST

DNS_QUERY_REQUEST

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 64 バイト / x86: 40 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
VersionDWORD4+0+0構造体のバージョン番号を示す。DNS_QUERY_REQUEST_VERSION1を指定する。
QueryNameLPWSTR8/4+8+4問い合わせるドメイン名を表すワイド文字列ポインタ。
QueryTypeWORD2+16+8問い合わせるレコード種別を示すDNSタイプ値。
QueryOptionsULONGLONG8+24+16解決動作を制御するDNS_QUERY_OPTIONSフラグを保持する。
pDnsServerListDNS_ADDR_ARRAY*8/4+32+24使用するDNSサーバ一覧を指すポインタ。NULLで既定サーバを使用。
InterfaceIndexDWORD4+40+28問い合わせに使用するネットワークインターフェースのインデックス。0で自動選択。
pQueryCompletionCallbackPDNS_QUERY_COMPLETION_ROUTINE8/4+48+32非同期完了時に呼ばれるコールバック関数のポインタ。
pQueryContextvoid*8/4+56+36コールバックに渡されるユーザ定義コンテキストポインタ。NULL可。

各言語での定義

#include <windows.h>

// DNS_QUERY_REQUEST  (x64 64 / x86 40 バイト)
typedef struct DNS_QUERY_REQUEST {
    DWORD Version;
    LPWSTR QueryName;
    WORD QueryType;
    ULONGLONG QueryOptions;
    DNS_ADDR_ARRAY* pDnsServerList;
    DWORD InterfaceIndex;
    PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
    void* pQueryContext;
} DNS_QUERY_REQUEST;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DNS_QUERY_REQUEST
{
    public uint Version;
    public IntPtr QueryName;
    public ushort QueryType;
    public ulong QueryOptions;
    public IntPtr pDnsServerList;
    public uint InterfaceIndex;
    public IntPtr pQueryCompletionCallback;
    public IntPtr pQueryContext;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DNS_QUERY_REQUEST
    Public Version As UInteger
    Public QueryName As IntPtr
    Public QueryType As UShort
    Public QueryOptions As ULong
    Public pDnsServerList As IntPtr
    Public InterfaceIndex As UInteger
    Public pQueryCompletionCallback As IntPtr
    Public pQueryContext As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class DNS_QUERY_REQUEST(ctypes.Structure):
    _fields_ = [
        ("Version", wintypes.DWORD),
        ("QueryName", ctypes.c_void_p),
        ("QueryType", ctypes.c_ushort),
        ("QueryOptions", ctypes.c_ulonglong),
        ("pDnsServerList", ctypes.c_void_p),
        ("InterfaceIndex", wintypes.DWORD),
        ("pQueryCompletionCallback", ctypes.c_void_p),
        ("pQueryContext", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct DNS_QUERY_REQUEST {
    pub Version: u32,
    pub QueryName: *mut core::ffi::c_void,
    pub QueryType: u16,
    pub QueryOptions: u64,
    pub pDnsServerList: *mut core::ffi::c_void,
    pub InterfaceIndex: u32,
    pub pQueryCompletionCallback: *mut core::ffi::c_void,
    pub pQueryContext: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type DNS_QUERY_REQUEST struct {
	Version uint32
	QueryName uintptr
	QueryType uint16
	QueryOptions uint64
	pDnsServerList uintptr
	InterfaceIndex uint32
	pQueryCompletionCallback uintptr
	pQueryContext uintptr
}
type
  DNS_QUERY_REQUEST = record
    Version: DWORD;
    QueryName: Pointer;
    QueryType: Word;
    QueryOptions: UInt64;
    pDnsServerList: Pointer;
    InterfaceIndex: DWORD;
    pQueryCompletionCallback: Pointer;
    pQueryContext: Pointer;
  end;
const DNS_QUERY_REQUEST = extern struct {
    Version: u32,
    QueryName: ?*anyopaque,
    QueryType: u16,
    QueryOptions: u64,
    pDnsServerList: ?*anyopaque,
    InterfaceIndex: u32,
    pQueryCompletionCallback: ?*anyopaque,
    pQueryContext: ?*anyopaque,
};
type
  DNS_QUERY_REQUEST {.bycopy.} = object
    Version: uint32
    QueryName: pointer
    QueryType: uint16
    QueryOptions: uint64
    pDnsServerList: pointer
    InterfaceIndex: uint32
    pQueryCompletionCallback: pointer
    pQueryContext: pointer
struct DNS_QUERY_REQUEST
{
    uint Version;
    void* QueryName;
    ushort QueryType;
    ulong QueryOptions;
    void* pDnsServerList;
    uint InterfaceIndex;
    void* pQueryCompletionCallback;
    void* pQueryContext;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DNS_QUERY_REQUEST サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; Version : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; QueryName : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; QueryType : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; QueryOptions : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pDnsServerList : DNS_ADDR_ARRAY* (+24, 4byte)  varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; InterfaceIndex : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; pQueryCompletionCallback : PDNS_QUERY_COMPLETION_ROUTINE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pQueryContext : void* (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DNS_QUERY_REQUEST サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; Version : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; QueryName : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; QueryType : WORD (+16, 2byte)  wpoke st,16,値  /  値 = wpeek(st,16)
; QueryOptions : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pDnsServerList : DNS_ADDR_ARRAY* (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; InterfaceIndex : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; pQueryCompletionCallback : PDNS_QUERY_COMPLETION_ROUTINE (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; pQueryContext : void* (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DNS_QUERY_REQUEST
    #field int Version
    #field intptr QueryName
    #field short QueryType
    #field int64 QueryOptions
    #field intptr pDnsServerList
    #field int InterfaceIndex
    #field intptr pQueryCompletionCallback
    #field intptr pQueryContext
#endstruct

stdim st, DNS_QUERY_REQUEST        ; NSTRUCT 変数を確保
st->Version = 100
mes "Version=" + st->Version