Win32 API 日本語リファレンス
ホーム › Networking.WinHttp › WINHTTP_RESOLVER_CACHE_CONFIG

WINHTTP_RESOLVER_CACHE_CONFIG

構造体
サイズx64: 32 バイト / x86: 32 バイトパッキング4

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

フィールド

フィールド型サイズx64x86説明
ulMaxResolverCacheEntriesDWORD4+0+0名前解決キャッシュに保持する最大エントリ数。
ulMaxCacheEntryAgeDWORD4+4+4キャッシュエントリの最大保持時間(秒)。
ulMinCacheEntryTtlDWORD4+8+8キャッシュエントリの最小TTL(秒)。
SecureDnsSettingWINHTTP_SECURE_DNS_SETTING4+12+12セキュアDNS(DoH)の使用方針を示す列挙値。
ullConnResolutionWaitTimeULONGLONG8+16+16接続時の名前解決待機時間(ミリ秒)。
ullFlagsULONGLONG8+24+24リゾルバーキャッシュ動作を制御するフラグビット。

各言語での定義

#include <windows.h>

// WINHTTP_RESOLVER_CACHE_CONFIG  (x64 32 / x86 32 バイト)
#pragma pack(push, 4)
typedef struct WINHTTP_RESOLVER_CACHE_CONFIG {
    DWORD ulMaxResolverCacheEntries;
    DWORD ulMaxCacheEntryAge;
    DWORD ulMinCacheEntryTtl;
    WINHTTP_SECURE_DNS_SETTING SecureDnsSetting;
    ULONGLONG ullConnResolutionWaitTime;
    ULONGLONG ullFlags;
} WINHTTP_RESOLVER_CACHE_CONFIG;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 4, CharSet = CharSet.Unicode)]
public struct WINHTTP_RESOLVER_CACHE_CONFIG
{
    public uint ulMaxResolverCacheEntries;
    public uint ulMaxCacheEntryAge;
    public uint ulMinCacheEntryTtl;
    public int SecureDnsSetting;
    public ulong ullConnResolutionWaitTime;
    public ulong ullFlags;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=4, CharSet:=CharSet.Unicode)>
Public Structure WINHTTP_RESOLVER_CACHE_CONFIG
    Public ulMaxResolverCacheEntries As UInteger
    Public ulMaxCacheEntryAge As UInteger
    Public ulMinCacheEntryTtl As UInteger
    Public SecureDnsSetting As Integer
    Public ullConnResolutionWaitTime As ULong
    Public ullFlags As ULong
End Structure
import ctypes
from ctypes import wintypes

class WINHTTP_RESOLVER_CACHE_CONFIG(ctypes.Structure):
    _pack_ = 4
    _fields_ = [
        ("ulMaxResolverCacheEntries", wintypes.DWORD),
        ("ulMaxCacheEntryAge", wintypes.DWORD),
        ("ulMinCacheEntryTtl", wintypes.DWORD),
        ("SecureDnsSetting", ctypes.c_int),
        ("ullConnResolutionWaitTime", ctypes.c_ulonglong),
        ("ullFlags", ctypes.c_ulonglong),
    ]
#[repr(C, packed(4))]
pub struct WINHTTP_RESOLVER_CACHE_CONFIG {
    pub ulMaxResolverCacheEntries: u32,
    pub ulMaxCacheEntryAge: u32,
    pub ulMinCacheEntryTtl: u32,
    pub SecureDnsSetting: i32,
    pub ullConnResolutionWaitTime: u64,
    pub ullFlags: u64,
}
import "golang.org/x/sys/windows"

type WINHTTP_RESOLVER_CACHE_CONFIG struct {
	ulMaxResolverCacheEntries uint32
	ulMaxCacheEntryAge uint32
	ulMinCacheEntryTtl uint32
	SecureDnsSetting int32
	ullConnResolutionWaitTime uint64
	ullFlags uint64
}
type
  WINHTTP_RESOLVER_CACHE_CONFIG = packed record
    ulMaxResolverCacheEntries: DWORD;
    ulMaxCacheEntryAge: DWORD;
    ulMinCacheEntryTtl: DWORD;
    SecureDnsSetting: Integer;
    ullConnResolutionWaitTime: UInt64;
    ullFlags: UInt64;
  end;
const WINHTTP_RESOLVER_CACHE_CONFIG = extern struct {
    ulMaxResolverCacheEntries: u32,
    ulMaxCacheEntryAge: u32,
    ulMinCacheEntryTtl: u32,
    SecureDnsSetting: i32,
    ullConnResolutionWaitTime: u64,
    ullFlags: u64,
};
type
  WINHTTP_RESOLVER_CACHE_CONFIG {.packed.} = object
    ulMaxResolverCacheEntries: uint32
    ulMaxCacheEntryAge: uint32
    ulMinCacheEntryTtl: uint32
    SecureDnsSetting: int32
    ullConnResolutionWaitTime: uint64
    ullFlags: uint64
align(4)
struct WINHTTP_RESOLVER_CACHE_CONFIG
{
    uint ulMaxResolverCacheEntries;
    uint ulMaxCacheEntryAge;
    uint ulMinCacheEntryTtl;
    int SecureDnsSetting;
    ulong ullConnResolutionWaitTime;
    ulong ullFlags;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WINHTTP_RESOLVER_CACHE_CONFIG サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; ulMaxResolverCacheEntries : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ulMaxCacheEntryAge : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ulMinCacheEntryTtl : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; SecureDnsSetting : WINHTTP_SECURE_DNS_SETTING (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ullConnResolutionWaitTime : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; ullFlags : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WINHTTP_RESOLVER_CACHE_CONFIG, pack=4
    #field int ulMaxResolverCacheEntries
    #field int ulMaxCacheEntryAge
    #field int ulMinCacheEntryTtl
    #field int SecureDnsSetting
    #field int64 ullConnResolutionWaitTime
    #field int64 ullFlags
#endstruct

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