Win32 API 日本語リファレンス
ホームSecurity.Cryptography.UI › CERT_SELECT_STRUCT_A

CERT_SELECT_STRUCT_A

構造体
サイズx64: 136 バイト / x86: 68 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズ (バイト単位)。
hwndParentHWND8/4+8+4CertSelectCertificate が生成する ダイアログボックスの親ウィンドウへのハンドル。
hInstanceHINSTANCE8/4+16+8ダイアログボックステンプレートを含む実行可能ファイルを持つモジュールへのハンドル。
pTemplateNameLPSTR8/4+24+12

dwFlags メンバーに CSS_ENABLETEMPLATE フラグが設定されている場合は、 DialogBoxIndirectParam がダイアログボックスの作成に使用するテンプレートを格納したグローバルメモリオブジェクトへのポインターを pTemplateName に設定します。ダイアログボックステンプレートは、ダイアログボックスを記述するヘッダーで構成されます。 ヘッダーの後ろには、ダイアログボックス内の各コントロールを記述する 1 つ以上のデータブロックが続きます。テンプレートには 標準形式または拡張形式のいずれかを使用できます。

dwFlagsCSS_ENABLETEMPLATEHANDLE フラグが設定されている場合、 pTemplateName はダイアログボックステンプレートを指定します。 pTemplateName は、ダイアログボックステンプレートの名前を指定する NULL 終端文字列へのポインターか、 ダイアログボックステンプレートのリソース識別子を指定する整数値のいずれかです。リソース識別子を指定する場合は、 その上位ワードが 0 で、下位ワードに識別子が含まれている必要があります。この整数値を作成する方法の 1 つは、 MAKEINTRESOURCE マクロを使用することです。

dwFlagsCERT_SELECT_STRUCT_FLAGS4+32+16

このメンバーには、次の値の 1 つ以上を指定できます。

意味
CSS_HIDE_PROPERTIES
[プロパティ] ボタンを非表示にします。
CSS_ENABLEHOOK
pfnHook でフックプロシージャを渡します。
CSS_ALLOWMULTISELECT
証明書の複数選択を有効にします。このオプションは現在サポートされておらず、無視されます。
CSS_SHOW_HELP
[ヘルプ] ボタンを表示します。
CSS_ENABLETEMPLATE
CertSelectCertificate 関数が DialogBoxIndirectParam 関数を呼び出して ダイアログボックスを作成するようにします。詳細については、pTemplateName を参照してください。
CSS_ENABLETEMPLATEHANDLE
CertSelectCertificate 関数が DialogBoxParam 関数を呼び出して ダイアログボックスを作成するようにします。詳細については、pTemplateName を参照してください。
szTitleLPSTR8/4+40+20ダイアログボックスのタイトルのテキストを格納する文字列へのポインター。
cCertStoreDWORD4+48+24arrayCertStore 配列内の要素数。
arrayCertStoreHCERTSTORE*8/4+56+28ダイアログボックスが証明書を列挙して表示する対象となる証明書ストアの配列へのポインター。 cCertStore メンバーには、この配列内の要素数が格納されます。
szPurposeOidLPSTR8/4+64+32拡張キー使用法 (EKU) のオブジェクト識別子 (OID) を文字列で表したものへのポインター。OID が指定された場合は、 この EKU を含む証明書のみが表示されます。
cCertContextDWORD4+72+36arrayCertContext 配列内の要素数。 CertSelectCertificate 関数から制御が戻った後、 このメンバーにはユーザーによって選択された証明書の数が格納されます。現在、ユーザーが選択できる証明書は 1 つだけです。
arrayCertContextCERT_CONTEXT**8/4+80+40

CERT_CONTEXT 構造体の配列へのポインター。cCertContext メンバーは、この配列内の要素数を指定します。 この配列には少なくとも 1 つの要素が含まれていなければなりません。

これらの構造体で表される証明書は、 CertSelectCertificate 関数が表示する ダイアログボックスが最初に表示されるときに選択された状態になります。現在使用されるのは、この配列の最初の証明書のみです。 CertSelectCertificate 関数が成功した場合、この配列の最初の証明書は CertFreeCertificateContext 関数で 解放されます。この配列の最初の要素が NULL の場合、ダイアログボックスでは最初はどの証明書も選択されません。

CertSelectCertificate 関数から 制御が戻った後、この配列にはユーザーによって選択された証明書が格納されます。現在、ユーザーが選択できる証明書は 1 つだけです。

lCustDataLPARAM8/4+88+44pfnFilter で参照されるフィルタープロシージャに渡されるカスタムデータを保持するバイト値の配列への ポインター。このカスタムデータは CertSelectCertificate 関数では使用されません。
pfnHookPFNCMHOOKPROC8/4+96+48フックコールバック関数への PFNCMHOOKPROC 関数ポインター。 この関数は、ダイアログボックスがメッセージを処理する前に呼び出されます。詳細については、 Hooks を参照してください。
pfnFilterPFNCMFILTERPROC8/4+104+52フィルターコールバック関数への PFNCMFILTERPROC 関数ポインター。 これは、ダイアログボックスにどの証明書を表示するかを判断するために呼び出されます。
szHelpFileNameLPSTR8/4+112+56ヘルプファイルへの完全なパスを格納する NULL 終端文字列へのポインター。
dwHelpIdDWORD4+120+60トピックのコンテキスト識別子。詳細については、 WinHelp を参照してください。
hprovUINT_PTR8/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 の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: uint
struct 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