ホーム › Security.Cryptography.UI › CRYPTUI_WIZ_EXPORT_INFO

CRYPTUI_WIZ_EXPORT_INFO

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 48 バイト / x86: 24 バイト

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

フィールド

型

サイズ

x64

x86

説明

dwSize

DWORD

この構造体のサイズ (バイト単位)。

pwszExportFileName

LPWSTR

8/4

エクスポート先の完全修飾ファイル名を格納する、NULL で終わる Unicode 文字列へのポインターです。このメンバーが NULL ではなく、かつ CryptUIWizExport 関数の dwFlags パラメーターに CRYPTUI_WIZ_NO_UI フラグが設定されていない場合、この文字列は既定のファイル名としてユーザーに表示されます。CRYPTUI_WIZ_NO_UI フラグが設定されている場合、このメンバーは必須です。それ以外の場合、このメンバーは省略可能です。

dwSubjectChoice

CRYPTUI_WIZ_EXPORT_SUBJECT

+16

エクスポートする対象の種類を示します。このメンバーには、次の値のいずれかを指定できます。

値	意味
CRYPTUI_WIZ_EXPORT_CERT_CONTEXT	pCertContext メンバーで指定された証明書コンテキストをエクスポートします。
CRYPTUI_WIZ_EXPORT_CTL_CONTEXT	pCTLContext メンバーで指定された証明書信頼リスト (CTL) コンテキストをエクスポートします。
CRYPTUI_WIZ_EXPORT_CRL_CONTEXT	pCRLContext メンバーで指定された証明書失効リスト (CRL) コンテキストをエクスポートします。
CRYPTUI_WIZ_EXPORT_CERT_STORE	hCertStore メンバーで指定された証明書ストアをエクスポートします。
CRYPTUI_WIZ_EXPORT_CERT_STORE_CERTIFICATES_ONLY	hCertStore メンバーで指定された証明書ストアから、証明書のみをエクスポートします。

Anonymous

_Anonymous_e__Union

8/4

+24

+12

dwSubjectChoiceに応じて証明書コンテキストやCRL/CTLコンテキストを保持する無名共用体。

cStores

DWORD

+32

+16

rghStores 配列の要素数。

rghStores

HCERTSTORE*

8/4

+40

+20

証明書と共に信頼チェーンをエクスポートする場合に、そのチェーン内の証明書を検索する対象となる追加の証明書ストアの配列です。 dwSubjectChoice が CRYPTUI_WIZ_EXPORT_CERT_CONTEXT 値以外の場合、このメンバーは無視されます。cStores メンバーには、この配列の要素数が格納されます。

共用体: _Anonymous_e__Union x64 8B / x86 4B

フィールド	型	サイズ	x64	x86	説明
pCertContext	CERT_CONTEXT*	8/4	+0	+0	エクスポートする証明書を格納する CERT_CONTEXT 構造体へのポインターです。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_EXPORT_CERT_CONTEXT が指定されている場合に使用されます。
pCTLContext	CTL_CONTEXT*	8/4	+0	+0	エクスポートする CTL を格納する CTL_CONTEXT 構造体へのポインターです。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_EXPORT_CTL_CONTEXT が指定されている場合に使用されます。
pCRLContext	CRL_CONTEXT*	8/4	+0	+0	エクスポートする CRL を格納する CRL_CONTEXT 構造体へのポインターです。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_EXPORT_CRL_CONTEXT が指定されている場合に使用されます。
hCertStore	HCERTSTORE	8/4	+0	+0	エクスポートする証明書ストアへのハンドルです。このメンバーは、dwSubjectChoice メンバーに CRYPTUI_WIZ_EXPORT_CERT_STORE または CRYPTUI_WIZ_EXPORT_CERT_STORE_CERTIFICATES_ONLY が指定されている場合に使用されます。

公式ドキュメント

[CRYPTUI_WIZ_EXPORT_INFO 構造体は、要件セクションに示されたオペレーティングシステムで使用できます。以降のバージョンでは変更されるか、使用できなくなる可能性があります。]

CRYPTUI_WIZ_EXPORT_INFO 構造体は、CryptUIWizExport 関数の動作を制御する情報を格納します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// CRYPTUI_WIZ_EXPORT_INFO  (x64 48 / x86 24 バイト)
typedef struct CRYPTUI_WIZ_EXPORT_INFO {
    DWORD dwSize;
    LPWSTR pwszExportFileName;
    CRYPTUI_WIZ_EXPORT_SUBJECT dwSubjectChoice;
    _Anonymous_e__Union Anonymous;
    DWORD cStores;
    HCERTSTORE* rghStores;
} CRYPTUI_WIZ_EXPORT_INFO;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPTUI_WIZ_EXPORT_INFO
{
    public uint dwSize;
    public IntPtr pwszExportFileName;
    public uint dwSubjectChoice;
    public _Anonymous_e__Union Anonymous;
    public uint cStores;
    public IntPtr rghStores;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPTUI_WIZ_EXPORT_INFO
    Public dwSize As UInteger
    Public pwszExportFileName As IntPtr
    Public dwSubjectChoice As UInteger
    Public Anonymous As _Anonymous_e__Union
    Public cStores As UInteger
    Public rghStores As IntPtr
End Structure

import ctypes
from ctypes import wintypes

class CRYPTUI_WIZ_EXPORT_INFO(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("pwszExportFileName", ctypes.c_void_p),
        ("dwSubjectChoice", wintypes.DWORD),
        ("Anonymous", _Anonymous_e__Union),
        ("cStores", wintypes.DWORD),
        ("rghStores", ctypes.c_void_p),
    ]

#[repr(C)]
pub struct CRYPTUI_WIZ_EXPORT_INFO {
    pub dwSize: u32,
    pub pwszExportFileName: *mut core::ffi::c_void,
    pub dwSubjectChoice: u32,
    pub Anonymous: _Anonymous_e__Union,
    pub cStores: u32,
    pub rghStores: *mut core::ffi::c_void,
}

import "golang.org/x/sys/windows"

type CRYPTUI_WIZ_EXPORT_INFO struct {
	dwSize uint32
	pwszExportFileName uintptr
	dwSubjectChoice uint32
	Anonymous _Anonymous_e__Union
	cStores uint32
	rghStores uintptr
}

type
  CRYPTUI_WIZ_EXPORT_INFO = record
    dwSize: DWORD;
    pwszExportFileName: Pointer;
    dwSubjectChoice: DWORD;
    Anonymous: _Anonymous_e__Union;
    cStores: DWORD;
    rghStores: Pointer;
  end;

const CRYPTUI_WIZ_EXPORT_INFO = extern struct {
    dwSize: u32,
    pwszExportFileName: ?*anyopaque,
    dwSubjectChoice: u32,
    Anonymous: _Anonymous_e__Union,
    cStores: u32,
    rghStores: ?*anyopaque,
};

type
  CRYPTUI_WIZ_EXPORT_INFO {.bycopy.} = object
    dwSize: uint32
    pwszExportFileName: pointer
    dwSubjectChoice: uint32
    Anonymous: _Anonymous_e__Union
    cStores: uint32
    rghStores: pointer

struct CRYPTUI_WIZ_EXPORT_INFO
{
    uint dwSize;
    void* pwszExportFileName;
    uint dwSubjectChoice;
    _Anonymous_e__Union Anonymous;
    uint cStores;
    void* rghStores;
}

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_EXPORT_INFO サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pwszExportFileName : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwSubjectChoice : CRYPTUI_WIZ_EXPORT_SUBJECT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; cStores : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; rghStores : HCERTSTORE* (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPTUI_WIZ_EXPORT_INFO サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pwszExportFileName : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; dwSubjectChoice : CRYPTUI_WIZ_EXPORT_SUBJECT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; cStores : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; rghStores : HCERTSTORE* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPTUI_WIZ_EXPORT_INFO
    #field int dwSize
    #field intptr pwszExportFileName
    #field int dwSubjectChoice
    #field byte Anonymous 8
    #field int cStores
    #field intptr rghStores
#endstruct

stdim st, CRYPTUI_WIZ_EXPORT_INFO        ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。