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

WINHTTP_AUTOPROXY_OPTIONS

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

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

フィールド

フィールド型サイズx64x86説明
dwFlagsDWORD4+0+0自動プロキシ取得方法を示すフラグ。WINHTTP_AUTOPROXY_AUTO_DETECTやCONFIG_URL等。
dwAutoDetectFlagsDWORD4+4+4自動検出方式のフラグ。DHCPやDNSによるPAC URL検出方法を指定する。
lpszAutoConfigUrlLPWSTR8/4+8+8明示的に指定するPACスクリプトのURL文字列。NULL可。
lpvReservedvoid*8/4+16+12予約済みフィールド。NULLを設定する。
dwReservedDWORD4+24+16予約済みフィールド。0を設定する。
fAutoLogonIfChallengedBOOL4+28+20認証要求時に自動でログオン資格情報を送るかを示すBOOL。TRUEで自動送信する。

各言語での定義

#include <windows.h>

// WINHTTP_AUTOPROXY_OPTIONS  (x64 32 / x86 24 バイト)
typedef struct WINHTTP_AUTOPROXY_OPTIONS {
    DWORD dwFlags;
    DWORD dwAutoDetectFlags;
    LPWSTR lpszAutoConfigUrl;
    void* lpvReserved;
    DWORD dwReserved;
    BOOL fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WINHTTP_AUTOPROXY_OPTIONS
{
    public uint dwFlags;
    public uint dwAutoDetectFlags;
    public IntPtr lpszAutoConfigUrl;
    public IntPtr lpvReserved;
    public uint dwReserved;
    [MarshalAs(UnmanagedType.Bool)] public bool fAutoLogonIfChallenged;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WINHTTP_AUTOPROXY_OPTIONS
    Public dwFlags As UInteger
    Public dwAutoDetectFlags As UInteger
    Public lpszAutoConfigUrl As IntPtr
    Public lpvReserved As IntPtr
    Public dwReserved As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public fAutoLogonIfChallenged As Boolean
End Structure
import ctypes
from ctypes import wintypes

class WINHTTP_AUTOPROXY_OPTIONS(ctypes.Structure):
    _fields_ = [
        ("dwFlags", wintypes.DWORD),
        ("dwAutoDetectFlags", wintypes.DWORD),
        ("lpszAutoConfigUrl", ctypes.c_void_p),
        ("lpvReserved", ctypes.c_void_p),
        ("dwReserved", wintypes.DWORD),
        ("fAutoLogonIfChallenged", wintypes.BOOL),
    ]
#[repr(C)]
pub struct WINHTTP_AUTOPROXY_OPTIONS {
    pub dwFlags: u32,
    pub dwAutoDetectFlags: u32,
    pub lpszAutoConfigUrl: *mut core::ffi::c_void,
    pub lpvReserved: *mut core::ffi::c_void,
    pub dwReserved: u32,
    pub fAutoLogonIfChallenged: i32,
}
import "golang.org/x/sys/windows"

type WINHTTP_AUTOPROXY_OPTIONS struct {
	dwFlags uint32
	dwAutoDetectFlags uint32
	lpszAutoConfigUrl uintptr
	lpvReserved uintptr
	dwReserved uint32
	fAutoLogonIfChallenged int32
}
type
  WINHTTP_AUTOPROXY_OPTIONS = record
    dwFlags: DWORD;
    dwAutoDetectFlags: DWORD;
    lpszAutoConfigUrl: Pointer;
    lpvReserved: Pointer;
    dwReserved: DWORD;
    fAutoLogonIfChallenged: BOOL;
  end;
const WINHTTP_AUTOPROXY_OPTIONS = extern struct {
    dwFlags: u32,
    dwAutoDetectFlags: u32,
    lpszAutoConfigUrl: ?*anyopaque,
    lpvReserved: ?*anyopaque,
    dwReserved: u32,
    fAutoLogonIfChallenged: i32,
};
type
  WINHTTP_AUTOPROXY_OPTIONS {.bycopy.} = object
    dwFlags: uint32
    dwAutoDetectFlags: uint32
    lpszAutoConfigUrl: pointer
    lpvReserved: pointer
    dwReserved: uint32
    fAutoLogonIfChallenged: int32
struct WINHTTP_AUTOPROXY_OPTIONS
{
    uint dwFlags;
    uint dwAutoDetectFlags;
    void* lpszAutoConfigUrl;
    void* lpvReserved;
    uint dwReserved;
    int fAutoLogonIfChallenged;
}

HSP用 定義

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

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

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