CERT_SELECT_STRUCT_A
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 | ||||||||||||||
| hwndParent | HWND | 8/4 | +8 | +4 | CertSelectCertificate が生成する ダイアログボックスの親ウィンドウへのハンドル。 | ||||||||||||||
| hInstance | HINSTANCE | 8/4 | +16 | +8 | ダイアログボックステンプレートを含む実行可能ファイルを持つモジュールへのハンドル。 | ||||||||||||||
| pTemplateName | LPSTR | 8/4 | +24 | +12 | dwFlags メンバーに CSS_ENABLETEMPLATE フラグが設定されている場合は、 DialogBoxIndirectParam がダイアログボックスの作成に使用するテンプレートを格納したグローバルメモリオブジェクトへのポインターを pTemplateName に設定します。ダイアログボックステンプレートは、ダイアログボックスを記述するヘッダーで構成されます。 ヘッダーの後ろには、ダイアログボックス内の各コントロールを記述する 1 つ以上のデータブロックが続きます。テンプレートには 標準形式または拡張形式のいずれかを使用できます。 dwFlags に CSS_ENABLETEMPLATEHANDLE フラグが設定されている場合、 pTemplateName はダイアログボックステンプレートを指定します。 pTemplateName は、ダイアログボックステンプレートの名前を指定する NULL 終端文字列へのポインターか、 ダイアログボックステンプレートのリソース識別子を指定する整数値のいずれかです。リソース識別子を指定する場合は、 その上位ワードが 0 で、下位ワードに識別子が含まれている必要があります。この整数値を作成する方法の 1 つは、 MAKEINTRESOURCE マクロを使用することです。 | ||||||||||||||
| dwFlags | CERT_SELECT_STRUCT_FLAGS | 4 | +32 | +16 | このメンバーには、次の値の 1 つ以上を指定できます。
| ||||||||||||||
| szTitle | LPSTR | 8/4 | +40 | +20 | ダイアログボックスのタイトルのテキストを格納する文字列へのポインター。 | ||||||||||||||
| cCertStore | DWORD | 4 | +48 | +24 | arrayCertStore 配列内の要素数。 | ||||||||||||||
| arrayCertStore | HCERTSTORE* | 8/4 | +56 | +28 | ダイアログボックスが証明書を列挙して表示する対象となる証明書ストアの配列へのポインター。 cCertStore メンバーには、この配列内の要素数が格納されます。 | ||||||||||||||
| szPurposeOid | LPSTR | 8/4 | +64 | +32 | 拡張キー使用法 (EKU) のオブジェクト識別子 (OID) を文字列で表したものへのポインター。OID が指定された場合は、 この EKU を含む証明書のみが表示されます。 | ||||||||||||||
| cCertContext | DWORD | 4 | +72 | +36 | arrayCertContext 配列内の要素数。 CertSelectCertificate 関数から制御が戻った後、 このメンバーにはユーザーによって選択された証明書の数が格納されます。現在、ユーザーが選択できる証明書は 1 つだけです。 | ||||||||||||||
| arrayCertContext | CERT_CONTEXT** | 8/4 | +80 | +40 | CERT_CONTEXT 構造体の配列へのポインター。cCertContext メンバーは、この配列内の要素数を指定します。 この配列には少なくとも 1 つの要素が含まれていなければなりません。 これらの構造体で表される証明書は、 CertSelectCertificate 関数が表示する ダイアログボックスが最初に表示されるときに選択された状態になります。現在使用されるのは、この配列の最初の証明書のみです。 CertSelectCertificate 関数が成功した場合、この配列の最初の証明書は CertFreeCertificateContext 関数で 解放されます。この配列の最初の要素が NULL の場合、ダイアログボックスでは最初はどの証明書も選択されません。 CertSelectCertificate 関数から 制御が戻った後、この配列にはユーザーによって選択された証明書が格納されます。現在、ユーザーが選択できる証明書は 1 つだけです。 | ||||||||||||||
| lCustData | LPARAM | 8/4 | +88 | +44 | pfnFilter で参照されるフィルタープロシージャに渡されるカスタムデータを保持するバイト値の配列への ポインター。このカスタムデータは CertSelectCertificate 関数では使用されません。 | ||||||||||||||
| pfnHook | PFNCMHOOKPROC | 8/4 | +96 | +48 | フックコールバック関数への PFNCMHOOKPROC 関数ポインター。 この関数は、ダイアログボックスがメッセージを処理する前に呼び出されます。詳細については、 Hooks を参照してください。 | ||||||||||||||
| pfnFilter | PFNCMFILTERPROC | 8/4 | +104 | +52 | フィルターコールバック関数への PFNCMFILTERPROC 関数ポインター。 これは、ダイアログボックスにどの証明書を表示するかを判断するために呼び出されます。 | ||||||||||||||
| szHelpFileName | LPSTR | 8/4 | +112 | +56 | ヘルプファイルへの完全なパスを格納する NULL 終端文字列へのポインター。 | ||||||||||||||
| dwHelpId | DWORD | 4 | +120 | +60 | トピックのコンテキスト識別子。詳細については、 WinHelp を参照してください。 | ||||||||||||||
| hprov | UINT_PTR | 8/4 | +128 | +64 | 証明書の検証に使用する Cryptographic Service Provider (CSP) へのハンドル。 |
公式ドキュメント
CERT_SELECT_STRUCT 構造体は、 証明書選択ダイアログボックスに表示される証明書を選択するための条件を格納します。この構造体は CertSelectCertificate 関数で使用されます。
解説(Remarks)
cryptdlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして CERT_SELECT_STRUCT を定義します。エンコード中立のエイリアスと、エンコード中立でないコードを混在して使用すると、不一致が発生してコンパイルエラーや実行時エラーの原因となる場合があります。詳細については、Conventions for Function Prototypes を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CERT_SELECT_STRUCT_A (x64 136 / x86 68 バイト)
typedef struct CERT_SELECT_STRUCT_A {
DWORD dwSize;
HWND hwndParent;
HINSTANCE hInstance;
LPSTR pTemplateName;
CERT_SELECT_STRUCT_FLAGS dwFlags;
LPSTR szTitle;
DWORD cCertStore;
HCERTSTORE* arrayCertStore;
LPSTR szPurposeOid;
DWORD cCertContext;
CERT_CONTEXT** arrayCertContext;
LPARAM lCustData;
PFNCMHOOKPROC pfnHook;
PFNCMFILTERPROC pfnFilter;
LPSTR szHelpFileName;
DWORD dwHelpId;
UINT_PTR hprov;
} CERT_SELECT_STRUCT_A;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CERT_SELECT_STRUCT_A
{
public uint dwSize;
public IntPtr hwndParent;
public IntPtr hInstance;
public IntPtr pTemplateName;
public uint dwFlags;
public IntPtr szTitle;
public uint cCertStore;
public IntPtr arrayCertStore;
public IntPtr szPurposeOid;
public uint cCertContext;
public IntPtr arrayCertContext;
public IntPtr lCustData;
public IntPtr pfnHook;
public IntPtr pfnFilter;
public IntPtr szHelpFileName;
public uint dwHelpId;
public UIntPtr hprov;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CERT_SELECT_STRUCT_A
Public dwSize As UInteger
Public hwndParent As IntPtr
Public hInstance As IntPtr
Public pTemplateName As IntPtr
Public dwFlags As UInteger
Public szTitle As IntPtr
Public cCertStore As UInteger
Public arrayCertStore As IntPtr
Public szPurposeOid As IntPtr
Public cCertContext As UInteger
Public arrayCertContext As IntPtr
Public lCustData As IntPtr
Public pfnHook As IntPtr
Public pfnFilter As IntPtr
Public szHelpFileName As IntPtr
Public dwHelpId As UInteger
Public hprov As UIntPtr
End Structureimport ctypes
from ctypes import wintypes
class CERT_SELECT_STRUCT_A(ctypes.Structure):
_fields_ = [
("dwSize", wintypes.DWORD),
("hwndParent", ctypes.c_void_p),
("hInstance", ctypes.c_void_p),
("pTemplateName", ctypes.c_void_p),
("dwFlags", wintypes.DWORD),
("szTitle", ctypes.c_void_p),
("cCertStore", wintypes.DWORD),
("arrayCertStore", ctypes.c_void_p),
("szPurposeOid", ctypes.c_void_p),
("cCertContext", wintypes.DWORD),
("arrayCertContext", ctypes.c_void_p),
("lCustData", ctypes.c_ssize_t),
("pfnHook", ctypes.c_void_p),
("pfnFilter", ctypes.c_void_p),
("szHelpFileName", ctypes.c_void_p),
("dwHelpId", wintypes.DWORD),
("hprov", ctypes.c_size_t),
]#[repr(C)]
pub struct CERT_SELECT_STRUCT_A {
pub dwSize: u32,
pub hwndParent: *mut core::ffi::c_void,
pub hInstance: *mut core::ffi::c_void,
pub pTemplateName: *mut core::ffi::c_void,
pub dwFlags: u32,
pub szTitle: *mut core::ffi::c_void,
pub cCertStore: u32,
pub arrayCertStore: *mut core::ffi::c_void,
pub szPurposeOid: *mut core::ffi::c_void,
pub cCertContext: u32,
pub arrayCertContext: *mut core::ffi::c_void,
pub lCustData: isize,
pub pfnHook: *mut core::ffi::c_void,
pub pfnFilter: *mut core::ffi::c_void,
pub szHelpFileName: *mut core::ffi::c_void,
pub dwHelpId: u32,
pub hprov: usize,
}import "golang.org/x/sys/windows"
type CERT_SELECT_STRUCT_A struct {
dwSize uint32
hwndParent uintptr
hInstance uintptr
pTemplateName uintptr
dwFlags uint32
szTitle uintptr
cCertStore uint32
arrayCertStore uintptr
szPurposeOid uintptr
cCertContext uint32
arrayCertContext uintptr
lCustData uintptr
pfnHook uintptr
pfnFilter uintptr
szHelpFileName uintptr
dwHelpId uint32
hprov uintptr
}type
CERT_SELECT_STRUCT_A = record
dwSize: DWORD;
hwndParent: Pointer;
hInstance: Pointer;
pTemplateName: Pointer;
dwFlags: DWORD;
szTitle: Pointer;
cCertStore: DWORD;
arrayCertStore: Pointer;
szPurposeOid: Pointer;
cCertContext: DWORD;
arrayCertContext: Pointer;
lCustData: NativeInt;
pfnHook: Pointer;
pfnFilter: Pointer;
szHelpFileName: Pointer;
dwHelpId: DWORD;
hprov: NativeUInt;
end;const CERT_SELECT_STRUCT_A = extern struct {
dwSize: u32,
hwndParent: ?*anyopaque,
hInstance: ?*anyopaque,
pTemplateName: ?*anyopaque,
dwFlags: u32,
szTitle: ?*anyopaque,
cCertStore: u32,
arrayCertStore: ?*anyopaque,
szPurposeOid: ?*anyopaque,
cCertContext: u32,
arrayCertContext: ?*anyopaque,
lCustData: isize,
pfnHook: ?*anyopaque,
pfnFilter: ?*anyopaque,
szHelpFileName: ?*anyopaque,
dwHelpId: u32,
hprov: usize,
};type
CERT_SELECT_STRUCT_A {.bycopy.} = object
dwSize: uint32
hwndParent: pointer
hInstance: pointer
pTemplateName: pointer
dwFlags: uint32
szTitle: pointer
cCertStore: uint32
arrayCertStore: pointer
szPurposeOid: pointer
cCertContext: uint32
arrayCertContext: pointer
lCustData: int
pfnHook: pointer
pfnFilter: pointer
szHelpFileName: pointer
dwHelpId: uint32
hprov: uintstruct CERT_SELECT_STRUCT_A
{
uint dwSize;
void* hwndParent;
void* hInstance;
void* pTemplateName;
uint dwFlags;
void* szTitle;
uint cCertStore;
void* arrayCertStore;
void* szPurposeOid;
uint cCertContext;
void* arrayCertContext;
ptrdiff_t lCustData;
void* pfnHook;
void* pfnFilter;
void* szHelpFileName;
uint dwHelpId;
size_t hprov;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CERT_SELECT_STRUCT_A サイズ: 68 バイト(x86)
dim st, 17 ; 4byte整数×17(構造体サイズ 68 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hwndParent : HWND (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; hInstance : HINSTANCE (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; pTemplateName : LPSTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; dwFlags : CERT_SELECT_STRUCT_FLAGS (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; szTitle : LPSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; cCertStore : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; arrayCertStore : HCERTSTORE* (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; szPurposeOid : LPSTR (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; cCertContext : DWORD (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; arrayCertContext : CERT_CONTEXT** (+40, 4byte) varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; lCustData : LPARAM (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; pfnHook : PFNCMHOOKPROC (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; pfnFilter : PFNCMFILTERPROC (+52, 4byte) st.13 = 値 / 値 = st.13 (lpoke/lpeek も可)
; szHelpFileName : LPSTR (+56, 4byte) st.14 = 値 / 値 = st.14 (lpoke/lpeek も可)
; dwHelpId : DWORD (+60, 4byte) st.15 = 値 / 値 = st.15 (lpoke/lpeek も可)
; hprov : UINT_PTR (+64, 4byte) st.16 = 値 / 値 = st.16 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CERT_SELECT_STRUCT_A サイズ: 136 バイト(x64)
dim st, 34 ; 4byte整数×34(構造体サイズ 136 / 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,上位
; hInstance : HINSTANCE (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pTemplateName : LPSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; dwFlags : CERT_SELECT_STRUCT_FLAGS (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; szTitle : LPSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; cCertStore : DWORD (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; arrayCertStore : HCERTSTORE* (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; szPurposeOid : LPSTR (+64, 8byte) qpoke st,64,値 / qpeek(st,64) ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; cCertContext : DWORD (+72, 4byte) st.18 = 値 / 値 = st.18 (lpoke/lpeek も可)
; arrayCertContext : CERT_CONTEXT** (+80, 8byte) varptr(st)+80 を基点に操作(8byte:入れ子/配列)
; lCustData : LPARAM (+88, 8byte) qpoke st,88,値 / qpeek(st,88) ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; pfnHook : PFNCMHOOKPROC (+96, 8byte) qpoke st,96,値 / qpeek(st,96) ※IronHSPのみ。3.7/3.8は lpoke st,96,下位 : lpoke st,100,上位
; pfnFilter : PFNCMFILTERPROC (+104, 8byte) qpoke st,104,値 / qpeek(st,104) ※IronHSPのみ。3.7/3.8は lpoke st,104,下位 : lpoke st,108,上位
; szHelpFileName : LPSTR (+112, 8byte) qpoke st,112,値 / qpeek(st,112) ※IronHSPのみ。3.7/3.8は lpoke st,112,下位 : lpoke st,116,上位
; dwHelpId : DWORD (+120, 4byte) st.30 = 値 / 値 = st.30 (lpoke/lpeek も可)
; hprov : UINT_PTR (+128, 8byte) qpoke st,128,値 / qpeek(st,128) ※IronHSPのみ。3.7/3.8は lpoke st,128,下位 : lpoke st,132,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CERT_SELECT_STRUCT_A
#field int dwSize
#field intptr hwndParent
#field intptr hInstance
#field intptr pTemplateName
#field int dwFlags
#field intptr szTitle
#field int cCertStore
#field intptr arrayCertStore
#field intptr szPurposeOid
#field int cCertContext
#field intptr arrayCertContext
#field intptr lCustData
#field intptr pfnHook
#field intptr pfnFilter
#field intptr szHelpFileName
#field int dwHelpId
#field intptr hprov
#endstruct
stdim st, CERT_SELECT_STRUCT_A ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize