CRYPTUI_WIZ_IMPORT_SRC_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 | ||||||||||
| dwSubjectChoice | CRYPTUI_WIZ_IMPORT_SUBJECT_OPTION | 4 | +4 | +4 | インポートするサブジェクトの種類を示します。このメンバーには、次のいずれかの値を指定できます。 | ||||||||||
| Anonymous | _Anonymous_e__Union | 8/4 | +8 | +8 | dwSubjectChoiceに応じてファイル名や各種コンテキストを保持する無名共用体。 | ||||||||||
| dwFlags | CRYPT_KEY_FLAGS | 4 | +16 | +12 | インポート操作を変更するフラグを格納します。このメンバーは、pwszFileName に個人情報交換 (PFX) BLOB が格納されている場合に必要です。それ以外の場合、このメンバーは無視されます。このメンバーには、0 または次の値の 1 つ以上の組み合わせを指定できます。
| ||||||||||
| pwszPassword | LPWSTR | 8/4 | +24 | +16 | 秘密キーへのアクセスに使用するパスワードを格納した、null で終わる Unicode 文字列へのポインター。pwszFileName に PFX BLOB が格納されている場合は、パスワードが必要です。パスワードが不要な場合、この変数は空の文字列でもかまいません。このメンバーを NULL にすることはできません。 |
共用体: _Anonymous_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pwszFileName | LPWSTR | 8/4 | +0 | +0 | インポートする証明書を含むファイルのパスとファイル名を格納した、null で終わる Unicode 文字列へのポインター。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_FILE が格納されている場合に使用されます。 |
| pCertContext | CERT_CONTEXT* | 8/4 | +0 | +0 | インポートする証明書を格納した CERT_CONTEXT 構造体へのポインター。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT が格納されている場合に使用されます。 |
| pCTLContext | CTL_CONTEXT* | 8/4 | +0 | +0 | インポートする CTL を格納した CTL_CONTEXT 構造体へのポインター。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT が格納されている場合に使用されます。 |
| pCRLContext | CRL_CONTEXT* | 8/4 | +0 | +0 | インポートする CRL を格納した CRL_CONTEXT 構造体へのポインター。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT が格納されている場合に使用されます。 |
| hCertStore | HCERTSTORE | 8/4 | +0 | +0 | インポートする証明書ストアへのハンドル。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE が格納されている場合に使用されます。 |
公式ドキュメント
[CRYPTUI_WIZ_IMPORT_SRC_INFO 構造体は、要件セクションに示されているオペレーティング システムで使用できます。以降のバージョンでは変更されるか、使用できなくなる可能性があります。]
CRYPTUI_WIZ_IMPORT_SRC_INFO 構造体には、CryptUIWizImport 関数にインポートするサブジェクトが格納されます。サブジェクトには、証明書、証明書信頼リスト (CTL)、または 証明書失効リスト (CRL) を指定できます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CRYPTUI_WIZ_IMPORT_SRC_INFO (x64 32 / x86 20 バイト)
typedef struct CRYPTUI_WIZ_IMPORT_SRC_INFO {
DWORD dwSize;
CRYPTUI_WIZ_IMPORT_SUBJECT_OPTION dwSubjectChoice;
_Anonymous_e__Union Anonymous;
CRYPT_KEY_FLAGS dwFlags;
LPWSTR pwszPassword;
} CRYPTUI_WIZ_IMPORT_SRC_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPTUI_WIZ_IMPORT_SRC_INFO
{
public uint dwSize;
public uint dwSubjectChoice;
public _Anonymous_e__Union Anonymous;
public uint dwFlags;
public IntPtr pwszPassword;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPTUI_WIZ_IMPORT_SRC_INFO
Public dwSize As UInteger
Public dwSubjectChoice As UInteger
Public Anonymous As _Anonymous_e__Union
Public dwFlags As UInteger
Public pwszPassword As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class CRYPTUI_WIZ_IMPORT_SRC_INFO(ctypes.Structure):
_fields_ = [
("dwSize", wintypes.DWORD),
("dwSubjectChoice", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
("dwFlags", wintypes.DWORD),
("pwszPassword", ctypes.c_void_p),
]#[repr(C)]
pub struct CRYPTUI_WIZ_IMPORT_SRC_INFO {
pub dwSize: u32,
pub dwSubjectChoice: u32,
pub Anonymous: _Anonymous_e__Union,
pub dwFlags: u32,
pub pwszPassword: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type CRYPTUI_WIZ_IMPORT_SRC_INFO struct {
dwSize uint32
dwSubjectChoice uint32
Anonymous _Anonymous_e__Union
dwFlags uint32
pwszPassword uintptr
}type
CRYPTUI_WIZ_IMPORT_SRC_INFO = record
dwSize: DWORD;
dwSubjectChoice: DWORD;
Anonymous: _Anonymous_e__Union;
dwFlags: DWORD;
pwszPassword: Pointer;
end;const CRYPTUI_WIZ_IMPORT_SRC_INFO = extern struct {
dwSize: u32,
dwSubjectChoice: u32,
Anonymous: _Anonymous_e__Union,
dwFlags: u32,
pwszPassword: ?*anyopaque,
};type
CRYPTUI_WIZ_IMPORT_SRC_INFO {.bycopy.} = object
dwSize: uint32
dwSubjectChoice: uint32
Anonymous: _Anonymous_e__Union
dwFlags: uint32
pwszPassword: pointerstruct CRYPTUI_WIZ_IMPORT_SRC_INFO
{
uint dwSize;
uint dwSubjectChoice;
_Anonymous_e__Union Anonymous;
uint dwFlags;
void* pwszPassword;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPTUI_WIZ_IMPORT_SRC_INFO サイズ: 20 バイト(x86)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwSubjectChoice : CRYPTUI_WIZ_IMPORT_SUBJECT_OPTION (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+8, 4byte) varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; dwFlags : CRYPT_KEY_FLAGS (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; pwszPassword : LPWSTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPTUI_WIZ_IMPORT_SRC_INFO サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwSubjectChoice : CRYPTUI_WIZ_IMPORT_SUBJECT_OPTION (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+8, 8byte) varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; dwFlags : CRYPT_KEY_FLAGS (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pwszPassword : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPTUI_WIZ_IMPORT_SRC_INFO
#field int dwSize
#field int dwSubjectChoice
#field byte Anonymous 8
#field int dwFlags
#field intptr pwszPassword
#endstruct
stdim st, CRYPTUI_WIZ_IMPORT_SRC_INFO ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。