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

AutoProxyHelperVtbl

構造体
サイズx64: 72 バイト / x86: 36 バイト

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

フィールド

フィールドサイズx64x86説明
IsResolvableINT_PTR8/4+0+0

指定されたホスト名の解決を試みます。この PAC 関数は、仕様書に同じ名前で記載されています。ホスト名を解決できる場合は TRUE を、それ以外の場合は FALSE を返します。

lpszHost

ホスト名を格納した文字列へのポインター。

GetIPAddressINT_PTR8/4+8+4

ローカルコンピューターの IP アドレスを、指定されたバッファーに格納します。この PAC 関数は、仕様書に myIPAddress という名前で記載されています。成功した場合は 0 を、失敗した場合はエラーコードを返します。

lpszIPAddress

IP アドレスを返すバッファーへのポインター。

lpdwIPAddressSize

lpszIPAddress が指すバッファーのサイズ。

ResolveHostNameINT_PTR8/4+16+8

ホスト名文字列に対応する IP アドレスを、指定されたバッファーに格納します。この PAC 関数は、仕様書に dnsResolve という名前で記載されています。成功した場合は TRUE を、それ以外の場合は FALSE を返します。

lpszHostName

解決するホスト名へのポインター。

lpszIPAddress

IP アドレスを返すバッファーへのポインター。

lpdwIPAddressSize

lpszIPAddress が指すバッファーのサイズ。

IsInNetINT_PTR8/4+24+12

指定されたマスク値でマスクした指定の IP アドレスが、指定された宛先アドレスと一致するかどうかを判定します。この PAC 関数は、仕様書に同じ名前で記載されています。

比較は、文字列表現をバイナリに変換し、マスクと lpszIPAddress で指定されたアドレスをビット単位の AND で演算し、その結果を lpszDest で指定されたアドレスと比較することによって行われます。

lpszIPAddress

マスクを適用する IP アドレスの文字列表現へのポインター。仕様書の host パラメーターに対応します。

lpszDest

比較対象となる IP アドレスの文字列表現へのポインター。仕様書の pattern パラメーターに対応します。

lpszMask

lpszIPAddress が指すアドレスに適用するマスクの文字列表現へのポインター。

IsResolvableExINT_PTR8/4+32+16

指定されたホスト名の解決を試みます。この PAC 関数は、仕様書に同じ名前で記載されています。ホスト名を解決できる場合は TRUE を、それ以外の場合は FALSE を返します。

Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。

lpszHost

ホスト名を格納した文字列。

GetIPAddressExINT_PTR8/4+40+20

ローカルコンピューターの IP アドレスを、指定されたバッファーに格納します。この PAC 関数は、仕様書に myIPAddress という名前で記載されています。成功した場合は 0 を、失敗した場合はエラーコードを返します。

Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。

lpszIPAddress

IP アドレスを返すバッファーへのポインター。

lpdwIPAddressSize

lpszIPAddress が指すバッファーのサイズ。

ResolveHostNameExINT_PTR8/4+48+24

ホスト名文字列に対応する IP アドレスを、指定されたバッファーに格納します。この PAC 関数は、仕様書に dnsResolve という名前で記載されています。成功した場合は TRUE を、それ以外の場合は FALSE を返します。

Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。

lpszHostName

解決するホスト名へのポインター。

lpszIPAddress

IP アドレスを返すバッファーへのポインター。

lpdwIPAddressSize

lpszIPAddress が指すバッファーのサイズ。

IsInNetExINT_PTR8/4+56+28

指定されたマスク値でマスクした指定の IP アドレスが、指定された宛先アドレスと一致するかどうかを判定します。この PAC 関数は、仕様書に同じ名前で記載されています。

Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。

lpszIPAddress

マスクを適用する IP アドレスの文字列表現へのポインター。仕様書の host パラメーターに対応します。

lpszIPPrefix

IP アドレスのプレフィックスを格納した文字列へのポインター。

SortIpListINT_PTR8/4+64+32

IP アドレスの一覧を並べ替えます。

Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。

lpszIPAddressList

並べ替える一覧へのポインター。

lpszIPSortedList

並べ替えられた一覧へのポインター。

lpdwIPSortedListSize

並べ替えられた一覧のサイズを格納したバッファーへのポインター。

公式ドキュメント

AutoProxyHelperVtbl 構造体は、Proxy AutoConfig (PAC) ヘルパー関数へのポインターの v-table を作成します。

Proxy Auto-Config ヘルパー関数の形式と使用方法の仕様については、Navigator Proxy Auto-Config (PAC) File Format のドキュメントを参照してください。

解説(Remarks)

AutoProxyHelperVtblAutoProxyHelperFunctions 構造体と共に使用し、C++ を使用せずに C だけで宣言および設定できる標準的な v-table を作成する役割を果たします。

注意 WinINet はサーバー実装をサポートしていません。また、サービスから使用することもできません。サーバー実装やサービスでは、Microsoft Windows HTTP Services (WinHTTP) を使用してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// AutoProxyHelperVtbl  (x64 72 / x86 36 バイト)
typedef struct AutoProxyHelperVtbl {
    INT_PTR IsResolvable;
    INT_PTR GetIPAddress;
    INT_PTR ResolveHostName;
    INT_PTR IsInNet;
    INT_PTR IsResolvableEx;
    INT_PTR GetIPAddressEx;
    INT_PTR ResolveHostNameEx;
    INT_PTR IsInNetEx;
    INT_PTR SortIpList;
} AutoProxyHelperVtbl;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct AutoProxyHelperVtbl
{
    public IntPtr IsResolvable;
    public IntPtr GetIPAddress;
    public IntPtr ResolveHostName;
    public IntPtr IsInNet;
    public IntPtr IsResolvableEx;
    public IntPtr GetIPAddressEx;
    public IntPtr ResolveHostNameEx;
    public IntPtr IsInNetEx;
    public IntPtr SortIpList;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure AutoProxyHelperVtbl
    Public IsResolvable As IntPtr
    Public GetIPAddress As IntPtr
    Public ResolveHostName As IntPtr
    Public IsInNet As IntPtr
    Public IsResolvableEx As IntPtr
    Public GetIPAddressEx As IntPtr
    Public ResolveHostNameEx As IntPtr
    Public IsInNetEx As IntPtr
    Public SortIpList As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class AutoProxyHelperVtbl(ctypes.Structure):
    _fields_ = [
        ("IsResolvable", ctypes.c_ssize_t),
        ("GetIPAddress", ctypes.c_ssize_t),
        ("ResolveHostName", ctypes.c_ssize_t),
        ("IsInNet", ctypes.c_ssize_t),
        ("IsResolvableEx", ctypes.c_ssize_t),
        ("GetIPAddressEx", ctypes.c_ssize_t),
        ("ResolveHostNameEx", ctypes.c_ssize_t),
        ("IsInNetEx", ctypes.c_ssize_t),
        ("SortIpList", ctypes.c_ssize_t),
    ]
#[repr(C)]
pub struct AutoProxyHelperVtbl {
    pub IsResolvable: isize,
    pub GetIPAddress: isize,
    pub ResolveHostName: isize,
    pub IsInNet: isize,
    pub IsResolvableEx: isize,
    pub GetIPAddressEx: isize,
    pub ResolveHostNameEx: isize,
    pub IsInNetEx: isize,
    pub SortIpList: isize,
}
import "golang.org/x/sys/windows"

type AutoProxyHelperVtbl struct {
	IsResolvable uintptr
	GetIPAddress uintptr
	ResolveHostName uintptr
	IsInNet uintptr
	IsResolvableEx uintptr
	GetIPAddressEx uintptr
	ResolveHostNameEx uintptr
	IsInNetEx uintptr
	SortIpList uintptr
}
type
  AutoProxyHelperVtbl = record
    IsResolvable: NativeInt;
    GetIPAddress: NativeInt;
    ResolveHostName: NativeInt;
    IsInNet: NativeInt;
    IsResolvableEx: NativeInt;
    GetIPAddressEx: NativeInt;
    ResolveHostNameEx: NativeInt;
    IsInNetEx: NativeInt;
    SortIpList: NativeInt;
  end;
const AutoProxyHelperVtbl = extern struct {
    IsResolvable: isize,
    GetIPAddress: isize,
    ResolveHostName: isize,
    IsInNet: isize,
    IsResolvableEx: isize,
    GetIPAddressEx: isize,
    ResolveHostNameEx: isize,
    IsInNetEx: isize,
    SortIpList: isize,
};
type
  AutoProxyHelperVtbl {.bycopy.} = object
    IsResolvable: int
    GetIPAddress: int
    ResolveHostName: int
    IsInNet: int
    IsResolvableEx: int
    GetIPAddressEx: int
    ResolveHostNameEx: int
    IsInNetEx: int
    SortIpList: int
struct AutoProxyHelperVtbl
{
    ptrdiff_t IsResolvable;
    ptrdiff_t GetIPAddress;
    ptrdiff_t ResolveHostName;
    ptrdiff_t IsInNet;
    ptrdiff_t IsResolvableEx;
    ptrdiff_t GetIPAddressEx;
    ptrdiff_t ResolveHostNameEx;
    ptrdiff_t IsInNetEx;
    ptrdiff_t SortIpList;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; AutoProxyHelperVtbl サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; IsResolvable : INT_PTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; GetIPAddress : INT_PTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ResolveHostName : INT_PTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; IsInNet : INT_PTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; IsResolvableEx : INT_PTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; GetIPAddressEx : INT_PTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ResolveHostNameEx : INT_PTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; IsInNetEx : INT_PTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; SortIpList : INT_PTR (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; AutoProxyHelperVtbl サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; IsResolvable : INT_PTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; GetIPAddress : INT_PTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; ResolveHostName : INT_PTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; IsInNet : INT_PTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; IsResolvableEx : INT_PTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; GetIPAddressEx : INT_PTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ResolveHostNameEx : INT_PTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; IsInNetEx : INT_PTR (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; SortIpList : INT_PTR (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global AutoProxyHelperVtbl
    #field intptr IsResolvable
    #field intptr GetIPAddress
    #field intptr ResolveHostName
    #field intptr IsInNet
    #field intptr IsResolvableEx
    #field intptr GetIPAddressEx
    #field intptr ResolveHostNameEx
    #field intptr IsInNetEx
    #field intptr SortIpList
#endstruct

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