ホーム › Security.Cryptography › VTableProvStrucW
VTableProvStrucW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| Version | DWORD | 4 | +0 | +0 | プロバイダーVTable構造体のバージョン番号。 |
| FuncVerifyImage | CRYPT_VERIFY_IMAGE_W | 8/4 | +8 | +4 | イメージ署名を検証するコールバック関数(Unicode)ポインタ。 |
| FuncReturnhWnd | CRYPT_RETURN_HWND | 8/4 | +16 | +8 | 親ウィンドウハンドルを返すコールバック関数ポインタ。 |
| dwProvType | DWORD | 4 | +24 | +12 | プロバイダーの種別を示す値。 |
| pbContextInfo | BYTE* | 8/4 | +32 | +16 | コンテキスト情報のバイト列へのポインタ。 |
| cbContextInfo | DWORD | 4 | +40 | +20 | コンテキスト情報のバイト長。 |
| pszProvName | LPWSTR | 8/4 | +48 | +24 | プロバイダー名を示すワイド文字列。 |
公式ドキュメント
VTableProvStruc 構造体には、暗号化サービスプロバイダー (CSP) の関数が使用できるコールバック関数へのポインターが格納されます。
解説(Remarks)
VTableProvStruc 構造体内のポインターは、CPAcquireContext 関数の中でのみ使用できます。CPAcquireContext の呼び出しが完了した後に構造体のメンバーが必要になる場合は、CSP が必要な構造体の要素をコピーしておく必要があります。この構造体内の関数ポインターは、CSP コンテキストが解放されるまで保存して使用できます。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)
各言語での定義
#include <windows.h>
// VTableProvStrucW (x64 56 / x86 28 バイト)
typedef struct VTableProvStrucW {
DWORD Version;
CRYPT_VERIFY_IMAGE_W FuncVerifyImage;
CRYPT_RETURN_HWND FuncReturnhWnd;
DWORD dwProvType;
BYTE* pbContextInfo;
DWORD cbContextInfo;
LPWSTR pszProvName;
} VTableProvStrucW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VTableProvStrucW
{
public uint Version;
public IntPtr FuncVerifyImage;
public IntPtr FuncReturnhWnd;
public uint dwProvType;
public IntPtr pbContextInfo;
public uint cbContextInfo;
public IntPtr pszProvName;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VTableProvStrucW
Public Version As UInteger
Public FuncVerifyImage As IntPtr
Public FuncReturnhWnd As IntPtr
Public dwProvType As UInteger
Public pbContextInfo As IntPtr
Public cbContextInfo As UInteger
Public pszProvName As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class VTableProvStrucW(ctypes.Structure):
_fields_ = [
("Version", wintypes.DWORD),
("FuncVerifyImage", ctypes.c_void_p),
("FuncReturnhWnd", ctypes.c_void_p),
("dwProvType", wintypes.DWORD),
("pbContextInfo", ctypes.c_void_p),
("cbContextInfo", wintypes.DWORD),
("pszProvName", ctypes.c_void_p),
]#[repr(C)]
pub struct VTableProvStrucW {
pub Version: u32,
pub FuncVerifyImage: *mut core::ffi::c_void,
pub FuncReturnhWnd: *mut core::ffi::c_void,
pub dwProvType: u32,
pub pbContextInfo: *mut core::ffi::c_void,
pub cbContextInfo: u32,
pub pszProvName: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type VTableProvStrucW struct {
Version uint32
FuncVerifyImage uintptr
FuncReturnhWnd uintptr
dwProvType uint32
pbContextInfo uintptr
cbContextInfo uint32
pszProvName uintptr
}type
VTableProvStrucW = record
Version: DWORD;
FuncVerifyImage: Pointer;
FuncReturnhWnd: Pointer;
dwProvType: DWORD;
pbContextInfo: Pointer;
cbContextInfo: DWORD;
pszProvName: Pointer;
end;const VTableProvStrucW = extern struct {
Version: u32,
FuncVerifyImage: ?*anyopaque,
FuncReturnhWnd: ?*anyopaque,
dwProvType: u32,
pbContextInfo: ?*anyopaque,
cbContextInfo: u32,
pszProvName: ?*anyopaque,
};type
VTableProvStrucW {.bycopy.} = object
Version: uint32
FuncVerifyImage: pointer
FuncReturnhWnd: pointer
dwProvType: uint32
pbContextInfo: pointer
cbContextInfo: uint32
pszProvName: pointerstruct VTableProvStrucW
{
uint Version;
void* FuncVerifyImage;
void* FuncReturnhWnd;
uint dwProvType;
void* pbContextInfo;
uint cbContextInfo;
void* pszProvName;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; VTableProvStrucW サイズ: 28 バイト(x86)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; Version : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; FuncVerifyImage : CRYPT_VERIFY_IMAGE_W (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; FuncReturnhWnd : CRYPT_RETURN_HWND (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwProvType : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; pbContextInfo : BYTE* (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; cbContextInfo : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; pszProvName : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VTableProvStrucW サイズ: 56 バイト(x64)
dim st, 14 ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; Version : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; FuncVerifyImage : CRYPT_VERIFY_IMAGE_W (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; FuncReturnhWnd : CRYPT_RETURN_HWND (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; dwProvType : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pbContextInfo : BYTE* (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; cbContextInfo : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; pszProvName : LPWSTR (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global VTableProvStrucW
#field int Version
#field intptr FuncVerifyImage
#field intptr FuncReturnhWnd
#field int dwProvType
#field intptr pbContextInfo
#field int cbContextInfo
#field intptr pszProvName
#endstruct
stdim st, VTableProvStrucW ; NSTRUCT 変数を確保
st->Version = 100
mes "Version=" + st->Version