WINTRUST_DATA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cbStruct | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 | ||||||||||||||||||||||||||||||
| pPolicyCallbackData | void* | 8/4 | +8 | +4 | ポリシー固有のデータをポリシー プロバイダーに渡すために使用されるデータ バッファーへのポインター。このメンバーは NULL にできます。 | ||||||||||||||||||||||||||||||
| pSIPClientData | void* | 8/4 | +16 | +8 | サブジェクト インターフェイス パッケージ (SIP) 固有のデータを SIP プロバイダーに渡すために使用されるデータ バッファーへのポインター。このメンバーは NULL にできます。 | ||||||||||||||||||||||||||||||
| dwUIChoice | WINTRUST_DATA_UICHOICE | 4 | +24 | +12 | 使用するユーザー インターフェイス (UI) の種類を指定します。このメンバーは、次のいずれかの値でなければなりません。
| ||||||||||||||||||||||||||||||
| fdwRevocationChecks | WINTRUST_DATA_REVOCATION_CHECKS | 4 | +28 | +16 | 証明書の失効チェックのオプション。このメンバーを設定すると、選択したポリシー プロバイダーが実行する失効チェックに加えて、失効チェックを追加できます。このメンバーは、次のいずれかの値でなければなりません。
| ||||||||||||||||||||||||||||||
| dwUnionChoice | WINTRUST_DATA_UNION_CHOICE | 4 | +32 | +20 | 使用する共用体メンバー、つまり信頼を検証する対象オブジェクトの種類を指定します。このメンバーは、次のいずれかの値でなければなりません。
| ||||||||||||||||||||||||||||||
| Anonymous | _Anonymous_e__Union | 8/4 | +40 | +24 | 検証対象(ファイル/カタログ/BLOB等)を保持する共用体。 | ||||||||||||||||||||||||||||||
| dwStateAction | WINTRUST_DATA_STATE_ACTION | 4 | +48 | +28 | 実行するアクションを指定します。次のいずれかの値を指定できます。
| ||||||||||||||||||||||||||||||
| hWVTStateData | HANDLE | 8/4 | +56 | +32 | 状態データへのハンドル。このメンバーの内容は、dwStateAction メンバーの値によって異なります。 | ||||||||||||||||||||||||||||||
| pwszURLReference | LPWSTR | 8/4 | +64 | +36 | 将来の使用のために予約されています。NULL を設定してください。 | ||||||||||||||||||||||||||||||
| dwProvFlags | WINTRUST_DATA_PROVIDER_FLAGS | 4 | +72 | +40 | トラスト プロバイダーの設定を指定する DWORD 値。次の値のうち 0 個以上をビット単位で組み合わせて指定できます。
| ||||||||||||||||||||||||||||||
| dwUIContext | WINTRUST_DATA_UICONTEXT | 4 | +76 | +44 | WinVerifyTrust 関数のユーザー インターフェイス コンテキストを指定する DWORD 値。これにより、Authenticode ダイアログ ボックスのテキストが、ファイルに対して実行される操作に合った内容になります。次のいずれかの値を指定できます。
| ||||||||||||||||||||||||||||||
| pSignatureSettings | WINTRUST_SIGNATURE_SETTINGS* | 8/4 | +80 | +48 | WINTRUST_SIGNATURE_SETTINGS 構造体へのポインター。 Windows 7 (KB3033929 適用)、Windows 8、および Windows Server 2012: このメンバーはこれ以降でサポートされます。 |
共用体: _Anonymous_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pFile | WINTRUST_FILE_INFO* | 8/4 | +0 | +0 | WINTRUST_FILE_INFO 構造体へのポインター。 |
| pCatalog | WINTRUST_CATALOG_INFO* | 8/4 | +0 | +0 | WINTRUST_CATALOG_INFO 構造体へのポインター。 |
| pBlob | WINTRUST_BLOB_INFO* | 8/4 | +0 | +0 | WINTRUST_BLOB_INFO 構造体へのポインター。 |
| pSgnr | WINTRUST_SGNR_INFO* | 8/4 | +0 | +0 | WINTRUST_SGNR_INFO 構造体へのポインター。 |
| pCert | WINTRUST_CERT_INFO* | 8/4 | +0 | +0 | WINTRUST_CERT_INFO 構造体へのポインター。 |
| pDetachedSig | WINTRUST_DETACHED_SIG_INFO* | 8/4 | +0 | +0 |
公式ドキュメント
[WINTRUST_DATA 構造体は、要件セクションに示されているオペレーティング システムで使用できます。以降のバージョンでは変更されるか、利用できなくなる可能性があります。]
WINTRUST_DATA 構造体は、 WinVerifyTrust を呼び出す際に、必要な情報を トラスト プロバイダー に渡すために使用されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// WINTRUST_DATA (x64 88 / x86 52 バイト)
typedef struct WINTRUST_DATA {
DWORD cbStruct;
void* pPolicyCallbackData;
void* pSIPClientData;
WINTRUST_DATA_UICHOICE dwUIChoice;
WINTRUST_DATA_REVOCATION_CHECKS fdwRevocationChecks;
WINTRUST_DATA_UNION_CHOICE dwUnionChoice;
_Anonymous_e__Union Anonymous;
WINTRUST_DATA_STATE_ACTION dwStateAction;
HANDLE hWVTStateData;
LPWSTR pwszURLReference;
WINTRUST_DATA_PROVIDER_FLAGS dwProvFlags;
WINTRUST_DATA_UICONTEXT dwUIContext;
WINTRUST_SIGNATURE_SETTINGS* pSignatureSettings;
} WINTRUST_DATA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WINTRUST_DATA
{
public uint cbStruct;
public IntPtr pPolicyCallbackData;
public IntPtr pSIPClientData;
public uint dwUIChoice;
public uint fdwRevocationChecks;
public uint dwUnionChoice;
public _Anonymous_e__Union Anonymous;
public uint dwStateAction;
public IntPtr hWVTStateData;
public IntPtr pwszURLReference;
public uint dwProvFlags;
public uint dwUIContext;
public IntPtr pSignatureSettings;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WINTRUST_DATA
Public cbStruct As UInteger
Public pPolicyCallbackData As IntPtr
Public pSIPClientData As IntPtr
Public dwUIChoice As UInteger
Public fdwRevocationChecks As UInteger
Public dwUnionChoice As UInteger
Public Anonymous As _Anonymous_e__Union
Public dwStateAction As UInteger
Public hWVTStateData As IntPtr
Public pwszURLReference As IntPtr
Public dwProvFlags As UInteger
Public dwUIContext As UInteger
Public pSignatureSettings As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class WINTRUST_DATA(ctypes.Structure):
_fields_ = [
("cbStruct", wintypes.DWORD),
("pPolicyCallbackData", ctypes.c_void_p),
("pSIPClientData", ctypes.c_void_p),
("dwUIChoice", wintypes.DWORD),
("fdwRevocationChecks", wintypes.DWORD),
("dwUnionChoice", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
("dwStateAction", wintypes.DWORD),
("hWVTStateData", ctypes.c_void_p),
("pwszURLReference", ctypes.c_void_p),
("dwProvFlags", wintypes.DWORD),
("dwUIContext", wintypes.DWORD),
("pSignatureSettings", ctypes.c_void_p),
]#[repr(C)]
pub struct WINTRUST_DATA {
pub cbStruct: u32,
pub pPolicyCallbackData: *mut core::ffi::c_void,
pub pSIPClientData: *mut core::ffi::c_void,
pub dwUIChoice: u32,
pub fdwRevocationChecks: u32,
pub dwUnionChoice: u32,
pub Anonymous: _Anonymous_e__Union,
pub dwStateAction: u32,
pub hWVTStateData: *mut core::ffi::c_void,
pub pwszURLReference: *mut core::ffi::c_void,
pub dwProvFlags: u32,
pub dwUIContext: u32,
pub pSignatureSettings: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type WINTRUST_DATA struct {
cbStruct uint32
pPolicyCallbackData uintptr
pSIPClientData uintptr
dwUIChoice uint32
fdwRevocationChecks uint32
dwUnionChoice uint32
Anonymous _Anonymous_e__Union
dwStateAction uint32
hWVTStateData uintptr
pwszURLReference uintptr
dwProvFlags uint32
dwUIContext uint32
pSignatureSettings uintptr
}type
WINTRUST_DATA = record
cbStruct: DWORD;
pPolicyCallbackData: Pointer;
pSIPClientData: Pointer;
dwUIChoice: DWORD;
fdwRevocationChecks: DWORD;
dwUnionChoice: DWORD;
Anonymous: _Anonymous_e__Union;
dwStateAction: DWORD;
hWVTStateData: Pointer;
pwszURLReference: Pointer;
dwProvFlags: DWORD;
dwUIContext: DWORD;
pSignatureSettings: Pointer;
end;const WINTRUST_DATA = extern struct {
cbStruct: u32,
pPolicyCallbackData: ?*anyopaque,
pSIPClientData: ?*anyopaque,
dwUIChoice: u32,
fdwRevocationChecks: u32,
dwUnionChoice: u32,
Anonymous: _Anonymous_e__Union,
dwStateAction: u32,
hWVTStateData: ?*anyopaque,
pwszURLReference: ?*anyopaque,
dwProvFlags: u32,
dwUIContext: u32,
pSignatureSettings: ?*anyopaque,
};type
WINTRUST_DATA {.bycopy.} = object
cbStruct: uint32
pPolicyCallbackData: pointer
pSIPClientData: pointer
dwUIChoice: uint32
fdwRevocationChecks: uint32
dwUnionChoice: uint32
Anonymous: _Anonymous_e__Union
dwStateAction: uint32
hWVTStateData: pointer
pwszURLReference: pointer
dwProvFlags: uint32
dwUIContext: uint32
pSignatureSettings: pointerstruct WINTRUST_DATA
{
uint cbStruct;
void* pPolicyCallbackData;
void* pSIPClientData;
uint dwUIChoice;
uint fdwRevocationChecks;
uint dwUnionChoice;
_Anonymous_e__Union Anonymous;
uint dwStateAction;
void* hWVTStateData;
void* pwszURLReference;
uint dwProvFlags;
uint dwUIContext;
void* pSignatureSettings;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; WINTRUST_DATA サイズ: 52 バイト(x86)
dim st, 13 ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pPolicyCallbackData : void* (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; pSIPClientData : void* (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwUIChoice : WINTRUST_DATA_UICHOICE (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; fdwRevocationChecks : WINTRUST_DATA_REVOCATION_CHECKS (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwUnionChoice : WINTRUST_DATA_UNION_CHOICE (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+24, 4byte) varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; dwStateAction : WINTRUST_DATA_STATE_ACTION (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; hWVTStateData : HANDLE (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; pwszURLReference : LPWSTR (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; dwProvFlags : WINTRUST_DATA_PROVIDER_FLAGS (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; dwUIContext : WINTRUST_DATA_UICONTEXT (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; pSignatureSettings : WINTRUST_SIGNATURE_SETTINGS* (+48, 4byte) varptr(st)+48 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WINTRUST_DATA サイズ: 88 バイト(x64)
dim st, 22 ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pPolicyCallbackData : void* (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pSIPClientData : void* (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; dwUIChoice : WINTRUST_DATA_UICHOICE (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; fdwRevocationChecks : WINTRUST_DATA_REVOCATION_CHECKS (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; dwUnionChoice : WINTRUST_DATA_UNION_CHOICE (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+40, 8byte) varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; dwStateAction : WINTRUST_DATA_STATE_ACTION (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; hWVTStateData : HANDLE (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pwszURLReference : LPWSTR (+64, 8byte) qpoke st,64,値 / qpeek(st,64) ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; dwProvFlags : WINTRUST_DATA_PROVIDER_FLAGS (+72, 4byte) st.18 = 値 / 値 = st.18 (lpoke/lpeek も可)
; dwUIContext : WINTRUST_DATA_UICONTEXT (+76, 4byte) st.19 = 値 / 値 = st.19 (lpoke/lpeek も可)
; pSignatureSettings : WINTRUST_SIGNATURE_SETTINGS* (+80, 8byte) varptr(st)+80 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WINTRUST_DATA
#field int cbStruct
#field intptr pPolicyCallbackData
#field intptr pSIPClientData
#field int dwUIChoice
#field int fdwRevocationChecks
#field int dwUnionChoice
#field byte Anonymous 8
#field int dwStateAction
#field intptr hWVTStateData
#field intptr pwszURLReference
#field int dwProvFlags
#field int dwUIContext
#field intptr pSignatureSettings
#endstruct
stdim st, WINTRUST_DATA ; NSTRUCT 変数を確保
st->cbStruct = 100
mes "cbStruct=" + st->cbStruct
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。