CRYPTUI_VIEWCERTIFICATE_STRUCTA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | CRYPTUI_VIEWCERTIFICATE_STRUCT 構造体のサイズ (バイト単位)。 | ||||||||||||||||||||||||||||||||||||||||||
| hwndParent | HWND | 8/4 | +8 | +4 | CryptUIDlgViewCertificate が表示するダイアログ ボックスの親となるウィンドウのハンドル。 | ||||||||||||||||||||||||||||||||||||||||||
| dwFlags | CRYPTUI_VIEWCERTIFICATE_FLAGS | 4 | +16 | +8 | このメンバーには次の値の 1 つ以上を指定できます。
| ||||||||||||||||||||||||||||||||||||||||||
| szTitle | LPSTR | 8/4 | +24 | +12 | ウィンドウのタイトルを格納する、null で終わる文字列へのポインター。 | ||||||||||||||||||||||||||||||||||||||||||
| pCertContext | CERT_CONTEXT* | 8/4 | +32 | +16 | 表示する証明書コンテキストを格納する CERT_CONTEXT 構造体へのポインター。 | ||||||||||||||||||||||||||||||||||||||||||
| rgszPurposes | LPSTR* | 8/4 | +40 | +20 | この証明書の検証対象となる目的を格納する、null で終わる文字列へのポインターの配列。 | ||||||||||||||||||||||||||||||||||||||||||
| cPurposes | DWORD | 4 | +48 | +24 | rgszPurposes 配列内の目的の数。 | ||||||||||||||||||||||||||||||||||||||||||
| Anonymous | _Anonymous_e__Union | 8/4 | +56 | +28 | 署名検証用のメッセージかストア情報を保持する無名共用体。 | ||||||||||||||||||||||||||||||||||||||||||
| fpCryptProviderDataTrustedUsage | BOOL | 4 | +64 | +32 | WinVerifyTrust が呼び出された場合、これはその証明書が信頼されたかどうかの結果です。 | ||||||||||||||||||||||||||||||||||||||||||
| idxSigner | DWORD | 4 | +68 | +36 | 表示する署名者のインデックス。 | ||||||||||||||||||||||||||||||||||||||||||
| idxCert | DWORD | 4 | +72 | +40 | 署名者チェーン内で表示されている証明書のインデックス。この証明書のコンテキストは pCertContext と一致しなければなりません。 | ||||||||||||||||||||||||||||||||||||||||||
| fCounterSigner | BOOL | 4 | +76 | +44 | 副署を表示している場合は TRUE。これが TRUE の場合は、idxCounterSigner が有効でなければなりません。 | ||||||||||||||||||||||||||||||||||||||||||
| idxCounterSigner | DWORD | 4 | +80 | +48 | 表示する副署者のインデックス。 | ||||||||||||||||||||||||||||||||||||||||||
| cStores | DWORD | 4 | +84 | +52 | 証明書チェーンの構築と検証の際に検索する証明書ストアの配列 rghStores 内の、その他のストアの数。 | ||||||||||||||||||||||||||||||||||||||||||
| rghStores | HCERTSTORE* | 8/4 | +88 | +56 | 証明書チェーンの構築と検証の際に検索する、その他の証明書ストアの HCERTSTORE ハンドルの配列。 | ||||||||||||||||||||||||||||||||||||||||||
| cPropSheetPages | DWORD | 4 | +96 | +60 | ダイアログ ボックスに追加するプロパティ ページの数。 | ||||||||||||||||||||||||||||||||||||||||||
| rgPropSheetPages | PROPSHEETPAGEA* | 8/4 | +104 | +64 | ダイアログ ボックスに追加するプロパティ ページの配列。 この配列内の各ページは、PROPSHEETPAGE 構造体の lParam を WM_INITDIALOG メッセージの lParam として受け取りません。代わりに CRYPTUI_INITDIALOG_STRUCT 構造体へのポインターを受け取ります。この構造体には、PROPSHEETPAGE 内の lParam と、そのページの表示対象となる CERT_CONTEXT へのポインターが格納されます。 | ||||||||||||||||||||||||||||||||||||||||||
| nStartPage | DWORD | 4 | +112 | +68 | 最初に表示されるページのインデックス。最上位ビット (0x8000) が設定されている場合、このインデックスは rgPropSheetPages のインデックスと見なされます (最上位ビットを取り除いた後の値で、たとえば 0x8000 は rgPropSheetPages の最初のページを示します)。最上位ビットが 0 の場合、nStartPage は既定の証明書ダイアログ ボックスのプロパティ ページの開始インデックスになります。 |
共用体: _Anonymous_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pCryptProviderData | CRYPT_PROVIDER_DATA* | 8/4 | +0 | +0 | その証明書に対して WinVerifyTrust 関数が既に呼び出されており、かつ WTHelperProvDataFromStateData 関数も呼び出されている場合は、WTHelperProvDataFromStateData の呼び出しで取得した状態構造体へのポインターを渡します。pCryptProviderData を設定する場合は、fpCryptProviderDataTrustedUsage、idxSigner、idxCert、fCounterSignature も設定しなければなりません。 |
| hWVTStateData | HANDLE | 8/4 | +0 | +0 | その証明書に対して WinVerifyTrust が既に呼び出されており、かつ WTHelperProvDataFromStateData が呼び出されていない場合は、WINTRUST_DATA 構造体の hWVTStateData メンバーを渡します。hWVTStateData を設定する場合は、fpCryptProviderDataTrustedUsage、idxSigner、idxCert、fCounterSignature も設定しなければなりません。 |
公式ドキュメント
CRYPTUI_VIEWCERTIFICATE_STRUCT 構造体は、表示する証明書に関する情報を格納します。この構造体は CryptUIDlgViewCertificate 関数で使用されます。
解説(Remarks)
cryptuiapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして CRYPTUI_VIEWCERTIFICATE_STRUCT を定義します。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させて使用すると、不一致が生じ、コンパイル エラーや実行時エラーの原因となる場合があります。詳細については、Conventions for Function Prototypes を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CRYPTUI_VIEWCERTIFICATE_STRUCTA (x64 120 / x86 72 バイト)
typedef struct CRYPTUI_VIEWCERTIFICATE_STRUCTA {
DWORD dwSize;
HWND hwndParent;
CRYPTUI_VIEWCERTIFICATE_FLAGS dwFlags;
LPSTR szTitle;
CERT_CONTEXT* pCertContext;
LPSTR* rgszPurposes;
DWORD cPurposes;
_Anonymous_e__Union Anonymous;
BOOL fpCryptProviderDataTrustedUsage;
DWORD idxSigner;
DWORD idxCert;
BOOL fCounterSigner;
DWORD idxCounterSigner;
DWORD cStores;
HCERTSTORE* rghStores;
DWORD cPropSheetPages;
PROPSHEETPAGEA* rgPropSheetPages;
DWORD nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPTUI_VIEWCERTIFICATE_STRUCTA
{
public uint dwSize;
public IntPtr hwndParent;
public uint dwFlags;
public IntPtr szTitle;
public IntPtr pCertContext;
public IntPtr rgszPurposes;
public uint cPurposes;
public _Anonymous_e__Union Anonymous;
[MarshalAs(UnmanagedType.Bool)] public bool fpCryptProviderDataTrustedUsage;
public uint idxSigner;
public uint idxCert;
[MarshalAs(UnmanagedType.Bool)] public bool fCounterSigner;
public uint idxCounterSigner;
public uint cStores;
public IntPtr rghStores;
public uint cPropSheetPages;
public IntPtr rgPropSheetPages;
public uint nStartPage;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPTUI_VIEWCERTIFICATE_STRUCTA
Public dwSize As UInteger
Public hwndParent As IntPtr
Public dwFlags As UInteger
Public szTitle As IntPtr
Public pCertContext As IntPtr
Public rgszPurposes As IntPtr
Public cPurposes As UInteger
Public Anonymous As _Anonymous_e__Union
<MarshalAs(UnmanagedType.Bool)> Public fpCryptProviderDataTrustedUsage As Boolean
Public idxSigner As UInteger
Public idxCert As UInteger
<MarshalAs(UnmanagedType.Bool)> Public fCounterSigner As Boolean
Public idxCounterSigner As UInteger
Public cStores As UInteger
Public rghStores As IntPtr
Public cPropSheetPages As UInteger
Public rgPropSheetPages As IntPtr
Public nStartPage As UInteger
End Structureimport ctypes
from ctypes import wintypes
class CRYPTUI_VIEWCERTIFICATE_STRUCTA(ctypes.Structure):
_fields_ = [
("dwSize", wintypes.DWORD),
("hwndParent", ctypes.c_void_p),
("dwFlags", wintypes.DWORD),
("szTitle", ctypes.c_void_p),
("pCertContext", ctypes.c_void_p),
("rgszPurposes", ctypes.c_void_p),
("cPurposes", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
("fpCryptProviderDataTrustedUsage", wintypes.BOOL),
("idxSigner", wintypes.DWORD),
("idxCert", wintypes.DWORD),
("fCounterSigner", wintypes.BOOL),
("idxCounterSigner", wintypes.DWORD),
("cStores", wintypes.DWORD),
("rghStores", ctypes.c_void_p),
("cPropSheetPages", wintypes.DWORD),
("rgPropSheetPages", ctypes.c_void_p),
("nStartPage", wintypes.DWORD),
]#[repr(C)]
pub struct CRYPTUI_VIEWCERTIFICATE_STRUCTA {
pub dwSize: u32,
pub hwndParent: *mut core::ffi::c_void,
pub dwFlags: u32,
pub szTitle: *mut core::ffi::c_void,
pub pCertContext: *mut core::ffi::c_void,
pub rgszPurposes: *mut core::ffi::c_void,
pub cPurposes: u32,
pub Anonymous: _Anonymous_e__Union,
pub fpCryptProviderDataTrustedUsage: i32,
pub idxSigner: u32,
pub idxCert: u32,
pub fCounterSigner: i32,
pub idxCounterSigner: u32,
pub cStores: u32,
pub rghStores: *mut core::ffi::c_void,
pub cPropSheetPages: u32,
pub rgPropSheetPages: *mut core::ffi::c_void,
pub nStartPage: u32,
}import "golang.org/x/sys/windows"
type CRYPTUI_VIEWCERTIFICATE_STRUCTA struct {
dwSize uint32
hwndParent uintptr
dwFlags uint32
szTitle uintptr
pCertContext uintptr
rgszPurposes uintptr
cPurposes uint32
Anonymous _Anonymous_e__Union
fpCryptProviderDataTrustedUsage int32
idxSigner uint32
idxCert uint32
fCounterSigner int32
idxCounterSigner uint32
cStores uint32
rghStores uintptr
cPropSheetPages uint32
rgPropSheetPages uintptr
nStartPage uint32
}type
CRYPTUI_VIEWCERTIFICATE_STRUCTA = record
dwSize: DWORD;
hwndParent: Pointer;
dwFlags: DWORD;
szTitle: Pointer;
pCertContext: Pointer;
rgszPurposes: Pointer;
cPurposes: DWORD;
Anonymous: _Anonymous_e__Union;
fpCryptProviderDataTrustedUsage: BOOL;
idxSigner: DWORD;
idxCert: DWORD;
fCounterSigner: BOOL;
idxCounterSigner: DWORD;
cStores: DWORD;
rghStores: Pointer;
cPropSheetPages: DWORD;
rgPropSheetPages: Pointer;
nStartPage: DWORD;
end;const CRYPTUI_VIEWCERTIFICATE_STRUCTA = extern struct {
dwSize: u32,
hwndParent: ?*anyopaque,
dwFlags: u32,
szTitle: ?*anyopaque,
pCertContext: ?*anyopaque,
rgszPurposes: ?*anyopaque,
cPurposes: u32,
Anonymous: _Anonymous_e__Union,
fpCryptProviderDataTrustedUsage: i32,
idxSigner: u32,
idxCert: u32,
fCounterSigner: i32,
idxCounterSigner: u32,
cStores: u32,
rghStores: ?*anyopaque,
cPropSheetPages: u32,
rgPropSheetPages: ?*anyopaque,
nStartPage: u32,
};type
CRYPTUI_VIEWCERTIFICATE_STRUCTA {.bycopy.} = object
dwSize: uint32
hwndParent: pointer
dwFlags: uint32
szTitle: pointer
pCertContext: pointer
rgszPurposes: pointer
cPurposes: uint32
Anonymous: _Anonymous_e__Union
fpCryptProviderDataTrustedUsage: int32
idxSigner: uint32
idxCert: uint32
fCounterSigner: int32
idxCounterSigner: uint32
cStores: uint32
rghStores: pointer
cPropSheetPages: uint32
rgPropSheetPages: pointer
nStartPage: uint32struct CRYPTUI_VIEWCERTIFICATE_STRUCTA
{
uint dwSize;
void* hwndParent;
uint dwFlags;
void* szTitle;
void* pCertContext;
void* rgszPurposes;
uint cPurposes;
_Anonymous_e__Union Anonymous;
int fpCryptProviderDataTrustedUsage;
uint idxSigner;
uint idxCert;
int fCounterSigner;
uint idxCounterSigner;
uint cStores;
void* rghStores;
uint cPropSheetPages;
void* rgPropSheetPages;
uint nStartPage;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPTUI_VIEWCERTIFICATE_STRUCTA サイズ: 72 バイト(x86)
dim st, 18 ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hwndParent : HWND (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwFlags : CRYPTUI_VIEWCERTIFICATE_FLAGS (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; szTitle : LPSTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; pCertContext : CERT_CONTEXT* (+16, 4byte) varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; rgszPurposes : LPSTR* (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; cPurposes : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+28, 4byte) varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; fpCryptProviderDataTrustedUsage : BOOL (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; idxSigner : DWORD (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; idxCert : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; fCounterSigner : BOOL (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; idxCounterSigner : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; cStores : DWORD (+52, 4byte) st.13 = 値 / 値 = st.13 (lpoke/lpeek も可)
; rghStores : HCERTSTORE* (+56, 4byte) st.14 = 値 / 値 = st.14 (lpoke/lpeek も可)
; cPropSheetPages : DWORD (+60, 4byte) st.15 = 値 / 値 = st.15 (lpoke/lpeek も可)
; rgPropSheetPages : PROPSHEETPAGEA* (+64, 4byte) varptr(st)+64 を基点に操作(4byte:入れ子/配列)
; nStartPage : DWORD (+68, 4byte) st.17 = 値 / 値 = st.17 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPTUI_VIEWCERTIFICATE_STRUCTA サイズ: 120 バイト(x64)
dim st, 30 ; 4byte整数×30(構造体サイズ 120 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hwndParent : HWND (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; dwFlags : CRYPTUI_VIEWCERTIFICATE_FLAGS (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; szTitle : LPSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; pCertContext : CERT_CONTEXT* (+32, 8byte) varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; rgszPurposes : LPSTR* (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; cPurposes : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+56, 8byte) varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; fpCryptProviderDataTrustedUsage : BOOL (+64, 4byte) st.16 = 値 / 値 = st.16 (lpoke/lpeek も可)
; idxSigner : DWORD (+68, 4byte) st.17 = 値 / 値 = st.17 (lpoke/lpeek も可)
; idxCert : DWORD (+72, 4byte) st.18 = 値 / 値 = st.18 (lpoke/lpeek も可)
; fCounterSigner : BOOL (+76, 4byte) st.19 = 値 / 値 = st.19 (lpoke/lpeek も可)
; idxCounterSigner : DWORD (+80, 4byte) st.20 = 値 / 値 = st.20 (lpoke/lpeek も可)
; cStores : DWORD (+84, 4byte) st.21 = 値 / 値 = st.21 (lpoke/lpeek も可)
; rghStores : HCERTSTORE* (+88, 8byte) qpoke st,88,値 / qpeek(st,88) ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; cPropSheetPages : DWORD (+96, 4byte) st.24 = 値 / 値 = st.24 (lpoke/lpeek も可)
; rgPropSheetPages : PROPSHEETPAGEA* (+104, 8byte) varptr(st)+104 を基点に操作(8byte:入れ子/配列)
; nStartPage : DWORD (+112, 4byte) st.28 = 値 / 値 = st.28 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPTUI_VIEWCERTIFICATE_STRUCTA
#field int dwSize
#field intptr hwndParent
#field int dwFlags
#field intptr szTitle
#field intptr pCertContext
#field intptr rgszPurposes
#field int cPurposes
#field byte Anonymous 8
#field bool fpCryptProviderDataTrustedUsage
#field int idxSigner
#field int idxCert
#field bool fCounterSigner
#field int idxCounterSigner
#field int cStores
#field intptr rghStores
#field int cPropSheetPages
#field intptr rgPropSheetPages
#field int nStartPage
#endstruct
stdim st, CRYPTUI_VIEWCERTIFICATE_STRUCTA ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。