AutoProxyHelperVtbl
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| IsResolvable | INT_PTR | 8/4 | +0 | +0 | 指定されたホスト名の解決を試みます。この PAC 関数は、仕様書に同じ名前で記載されています。ホスト名を解決できる場合は TRUE を、それ以外の場合は FALSE を返します。 lpszHostホスト名を格納した文字列へのポインター。 |
| GetIPAddress | INT_PTR | 8/4 | +8 | +4 | ローカルコンピューターの IP アドレスを、指定されたバッファーに格納します。この PAC 関数は、仕様書に myIPAddress という名前で記載されています。成功した場合は 0 を、失敗した場合はエラーコードを返します。 lpszIPAddressIP アドレスを返すバッファーへのポインター。 lpdwIPAddressSizelpszIPAddress が指すバッファーのサイズ。 |
| ResolveHostName | INT_PTR | 8/4 | +16 | +8 | ホスト名文字列に対応する IP アドレスを、指定されたバッファーに格納します。この PAC 関数は、仕様書に dnsResolve という名前で記載されています。成功した場合は TRUE を、それ以外の場合は FALSE を返します。 lpszHostName解決するホスト名へのポインター。 lpszIPAddressIP アドレスを返すバッファーへのポインター。 lpdwIPAddressSizelpszIPAddress が指すバッファーのサイズ。 |
| IsInNet | INT_PTR | 8/4 | +24 | +12 | 指定されたマスク値でマスクした指定の IP アドレスが、指定された宛先アドレスと一致するかどうかを判定します。この PAC 関数は、仕様書に同じ名前で記載されています。 比較は、文字列表現をバイナリに変換し、マスクと lpszIPAddress で指定されたアドレスをビット単位の AND で演算し、その結果を lpszDest で指定されたアドレスと比較することによって行われます。 lpszIPAddressマスクを適用する IP アドレスの文字列表現へのポインター。仕様書の host パラメーターに対応します。 lpszDest比較対象となる IP アドレスの文字列表現へのポインター。仕様書の pattern パラメーターに対応します。 lpszMasklpszIPAddress が指すアドレスに適用するマスクの文字列表現へのポインター。 |
| IsResolvableEx | INT_PTR | 8/4 | +32 | +16 | 指定されたホスト名の解決を試みます。この PAC 関数は、仕様書に同じ名前で記載されています。ホスト名を解決できる場合は TRUE を、それ以外の場合は FALSE を返します。 Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。 lpszHostホスト名を格納した文字列。 |
| GetIPAddressEx | INT_PTR | 8/4 | +40 | +20 | ローカルコンピューターの IP アドレスを、指定されたバッファーに格納します。この PAC 関数は、仕様書に myIPAddress という名前で記載されています。成功した場合は 0 を、失敗した場合はエラーコードを返します。 Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。 lpszIPAddressIP アドレスを返すバッファーへのポインター。 lpdwIPAddressSizelpszIPAddress が指すバッファーのサイズ。 |
| ResolveHostNameEx | INT_PTR | 8/4 | +48 | +24 | ホスト名文字列に対応する IP アドレスを、指定されたバッファーに格納します。この PAC 関数は、仕様書に dnsResolve という名前で記載されています。成功した場合は TRUE を、それ以外の場合は FALSE を返します。 Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。 lpszHostName解決するホスト名へのポインター。 lpszIPAddressIP アドレスを返すバッファーへのポインター。 lpdwIPAddressSizelpszIPAddress が指すバッファーのサイズ。 |
| IsInNetEx | INT_PTR | 8/4 | +56 | +28 | 指定されたマスク値でマスクした指定の IP アドレスが、指定された宛先アドレスと一致するかどうかを判定します。この PAC 関数は、仕様書に同じ名前で記載されています。 Windows XP 以前: Internet Explorer 7 を搭載した Windows XP with SP2 でのみ使用できます。それ以外では使用できません。 lpszIPAddressマスクを適用する IP アドレスの文字列表現へのポインター。仕様書の host パラメーターに対応します。 lpszIPPrefixIP アドレスのプレフィックスを格納した文字列へのポインター。 |
| SortIpList | INT_PTR | 8/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)
AutoProxyHelperVtbl は AutoProxyHelperFunctions 構造体と共に使用し、C++ を使用せずに C だけで宣言および設定できる標準的な v-table を作成する役割を果たします。
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 Structureimport 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: intstruct 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