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

WINHTTP_AUTOPROXY_OPTIONS

構造体
サイズx64: 32 バイト / x86: 24 バイト

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

フィールド

フィールドサイズx64x86説明
dwFlagsDWORD4+0+0

PAC ファイルの取得に使用するメカニズムを指定します。

意味
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
自動構成 URL によるプロキシ検出を有効にします。
メモ このフラグのサポートは Windows 10 バージョン 1703 (10.0; ビルド 15063) で導入されました。
WINHTTP_AUTOPROXY_ALLOW_CM
接続マネージャーによるプロキシ検出を有効にします。
メモ このフラグのサポートは Windows 10 バージョン 1703 (10.0; ビルド 15063) で導入されました。
WINHTTP_AUTOPROXY_ALLOW_STATIC
静的構成によるプロキシ検出を有効にします。
メモ このフラグのサポートは Windows 10 バージョン 1703 (10.0; ビルド 15063) で導入されました。
WINHTTP_AUTOPROXY_AUTO_DETECT
ローカルネットワークへの DHCP と DNS の両方のクエリを使用して、PAC ファイルの URL の自動検出を試みます。
WINHTTP_AUTOPROXY_CONFIG_URL
WINHTTP_AUTOPROXY_OPTIONS 構造体の lpszAutoConfigUrl で指定された URL から PAC ファイルをダウンロードします。
WINHTTP_AUTOPROXY_HOST_KEEPCASE
PAC スクリプトに渡すホスト名の大文字と小文字を維持します。これが既定の動作です。
WINHTTP_AUTOPROXY_HOST_LOWERCASE
ホスト名を小文字に変換してから PAC スクリプトに渡します。
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
現在のプロセスにおける、スクリプト実行結果のホストからプロキシへのキャッシュに対する問い合わせを無効にします。
WINHTTP_AUTOPROXY_NO_CACHE_SVC
自動プロキシサービスにおける、スクリプト実行結果のホストからプロキシへのキャッシュに対する問い合わせを無効にします。
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
この要求に対する Direct Access のプロキシ設定の問い合わせを無効にします。
WINHTTP_AUTOPROXY_RUN_INPROCESS
利用可能な場合でも、プロセス外の WinHTTP AutoProxy サービスに委任せず、Web Proxy Auto-Discovery (WPAD) プロトコルをプロセス内で実行します。このフラグは他のいずれかのフラグと組み合わせる必要があります。

このオプションは WinHttpGetProxyForUrlEx に渡した場合は効果がありません。

メモ このフラグは非推奨です。
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
既定では、WinHTTP はプロセス内でのプロキシ自動検出にフォールバックするよう構成されています。プロセス外での検出が失敗した場合にこのフォールバック動作が望ましくないときは、このフラグを使用して無効にできます。

このオプションは WinHttpGetProxyForUrlEx に渡した場合は効果がありません。

メモ このフラグは Windows Server 2003 でのみ使用できます。
WINHTTP_AUTOPROXY_SORT_RESULTS
最も高速なプロキシを先頭に配置するヒューリスティックに基づいて、プロキシの結果を並べ替えます。
dwAutoDetectFlagsDWORD4+4+4

dwFlagsWINHTTP_AUTOPROXY_AUTO_DETECT フラグが含まれる場合、dwAutoDetectFlags は PAC ファイルの検出に使用するプロトコルを指定します。DHCP と DNS の両方の自動検出フラグが指定された場合は、まず DHCP が使用されます。DHCP で PAC の URL が検出されなかった場合は DNS が使用されます。

dwFlagsWINHTTP_AUTOPROXY_AUTO_DETECT フラグが含まれない場合、dwAutoDetectFlags は 0 でなければなりません。

意味
WINHTTP_AUTO_DETECT_TYPE_DHCP
DHCP を使用してプロキシ自動構成ファイルを検出します。
WINHTTP_AUTO_DETECT_TYPE_DNS_A
DNS を使用して、ローカルコンピューターのドメイン上の既知の場所にあるプロキシ自動構成ファイルの検出を試みます。
lpszAutoConfigUrlLPWSTR8/4+8+8

dwFlagsWINHTTP_AUTOPROXY_CONFIG_URL フラグが含まれる場合、lpszAutoConfigUrl はプロキシ自動構成 (PAC) ファイルの URL を格納した null 終端の Unicode 文字列を指していなければなりません。

dwFlagsWINHTTP_AUTOPROXY_CONFIG_URL フラグが含まれない場合、lpszAutoConfigUrlNULL でなければなりません。

lpvReservedvoid*8/4+16+12将来の使用のために予約済みです。NULL でなければなりません。
dwReservedDWORD4+24+16将来の使用のために予約済みです。0 でなければなりません。
fAutoLogonIfChallengedBOOL4+28+20

WinHTTP が PAC ファイルを要求する際に NTLM または Negotiate 認証のチャレンジを受けた場合に、クライアントのドメイン資格情報を自動的に送信するかどうかを指定します。

このフラグが TRUE の場合、認証のチャレンジに応じて資格情報が自動的に送信されます。このフラグが FALSE で、PAC ファイルのダウンロードに認証が必要な場合、WinHttpGetProxyForUrl 関数は失敗します。

公式ドキュメント

WINHTTP_AUTOPROXY_OPTIONS 構造体は、プロキシ自動構成 (PAC) ファイルの URL を指定するか、ネットワークへの DHCP または DNS クエリによって URL を自動的に検出するかを WinHttpGetProxyForURL 関数に示すために使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#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