CRYPT_KEY_PROV_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| pwszContainerName | LPWSTR | 8/4 | +0 | +0 | キーコンテナーの名前を格納する、null で終わる Unicode 文字列へのポインターです。 dwProvType メンバーが 0 の場合、この文字列は CNG キーストレージプロバイダー内のキーの名前を格納します。この文字列は NCryptOpenKey 関数の pwszKeyName パラメーターとして渡されます。 | ||||||||
| pwszProvName | LPWSTR | 8/4 | +8 | +4 | CSP の名前を格納する、null で終わる Unicode 文字列へのポインターです。 dwProvType メンバーが 0 の場合、この文字列は CNG キーストレージプロバイダーの名前を格納します。この文字列は NCryptOpenStorageProvider 関数の pwszProviderName パラメーターとして渡されます。 | ||||||||
| dwProvType | DWORD | 4 | +16 | +8 | CSP の種類を指定します。0 または Cryptographic Provider Types のいずれかを指定できます。 このメンバーが 0 の場合、キーコンテナーは CNG キーストレージプロバイダーのいずれかです。 | ||||||||
| dwFlags | CRYPT_KEY_FLAGS | 4 | +20 | +12 | プロバイダーに関する追加情報を示すフラグのセットです。0 または次のいずれかの値を指定できます。
暗号化関数 CryptDecryptMessage、 CryptSignMessage、 CryptDecryptAndVerifyMessageSignature、および CryptSignAndEncryptMessage は、証明書から取得した CRYPT_KEY_PROV_INFO を使用して、内部的に CryptAcquireContext の操作を実行します。CERT_SET_KEY_CONTEXT_PROP_ID フラグまたは CERT_SET_KEY_PROV_HANDLE_PROP_ID フラグが設定されている場合、これらの暗号化関数は CERT_KEY_CONTEXT_PROP_ID を指定して CertSetCertificateContextProperty を呼び出すことができます。この呼び出しにより、同じ証明書を使用する上記の暗号化関数の以降の呼び出しに対して、キープロバイダーへのハンドルを開いたまま保持できるようになり、CryptAcquireContext を追加で呼び出す必要がなくなるため、効率が向上します。また、プロバイダーによっては CryptAcquireContext の呼び出し時にパスワードの入力が必要になる場合があるため、アプリケーションは CryptAcquireContext の呼び出し回数を最小限に抑えることが望まれます。開いたまま保持されたキープロバイダーのハンドルは、ストアが閉じられるときに自動的に解放されます。 たとえば、同じ証明書の公開キーで暗号化された 5 つのメッセージを受信した電子メールアプリケーションを考えます。最初のメッセージを処理した後もキープロバイダーへのハンドルを開いたまま保持していれば、残りの 4 つのメッセージについては CryptAcquireContext の呼び出しは不要です。 | ||||||||
| cProvParam | DWORD | 4 | +24 | +16 | rgProvParam 配列の要素数です。 dwProvType メンバーが 0 の場合、このメンバーは使用されず、0 でなければなりません。 | ||||||||
| rgProvParam | CRYPT_KEY_PROV_PARAM* | 8/4 | +32 | +20 | キーコンテナーのパラメーターを格納する CRYPT_KEY_PROV_PARAM 構造体の配列です。cProvParam メンバーには、この配列の要素数が格納されます。 dwProvType メンバーが 0 の場合、このメンバーは使用されず、NULL でなければなりません。 | ||||||||
| dwKeySpec | DWORD | 4 | +40 | +24 | 取得する秘密キーの指定です。 既定のプロバイダーに対しては、次の値が定義されています。 dwProvType メンバーが 0 の場合、この値は NCryptOpenKey 関数の dwLegacyKeySpec パラメーターとして渡されます。
|
公式ドキュメント
CRYPT_KEY_PROV_INFO 構造体は、暗号化サービスプロバイダー (CSP) 内のキーコンテナーに関する情報を格納します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CRYPT_KEY_PROV_INFO (x64 48 / x86 28 バイト)
typedef struct CRYPT_KEY_PROV_INFO {
LPWSTR pwszContainerName;
LPWSTR pwszProvName;
DWORD dwProvType;
CRYPT_KEY_FLAGS dwFlags;
DWORD cProvParam;
CRYPT_KEY_PROV_PARAM* rgProvParam;
DWORD dwKeySpec;
} CRYPT_KEY_PROV_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_KEY_PROV_INFO
{
public IntPtr pwszContainerName;
public IntPtr pwszProvName;
public uint dwProvType;
public uint dwFlags;
public uint cProvParam;
public IntPtr rgProvParam;
public uint dwKeySpec;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPT_KEY_PROV_INFO
Public pwszContainerName As IntPtr
Public pwszProvName As IntPtr
Public dwProvType As UInteger
Public dwFlags As UInteger
Public cProvParam As UInteger
Public rgProvParam As IntPtr
Public dwKeySpec As UInteger
End Structureimport ctypes
from ctypes import wintypes
class CRYPT_KEY_PROV_INFO(ctypes.Structure):
_fields_ = [
("pwszContainerName", ctypes.c_void_p),
("pwszProvName", ctypes.c_void_p),
("dwProvType", wintypes.DWORD),
("dwFlags", wintypes.DWORD),
("cProvParam", wintypes.DWORD),
("rgProvParam", ctypes.c_void_p),
("dwKeySpec", wintypes.DWORD),
]#[repr(C)]
pub struct CRYPT_KEY_PROV_INFO {
pub pwszContainerName: *mut core::ffi::c_void,
pub pwszProvName: *mut core::ffi::c_void,
pub dwProvType: u32,
pub dwFlags: u32,
pub cProvParam: u32,
pub rgProvParam: *mut core::ffi::c_void,
pub dwKeySpec: u32,
}import "golang.org/x/sys/windows"
type CRYPT_KEY_PROV_INFO struct {
pwszContainerName uintptr
pwszProvName uintptr
dwProvType uint32
dwFlags uint32
cProvParam uint32
rgProvParam uintptr
dwKeySpec uint32
}type
CRYPT_KEY_PROV_INFO = record
pwszContainerName: Pointer;
pwszProvName: Pointer;
dwProvType: DWORD;
dwFlags: DWORD;
cProvParam: DWORD;
rgProvParam: Pointer;
dwKeySpec: DWORD;
end;const CRYPT_KEY_PROV_INFO = extern struct {
pwszContainerName: ?*anyopaque,
pwszProvName: ?*anyopaque,
dwProvType: u32,
dwFlags: u32,
cProvParam: u32,
rgProvParam: ?*anyopaque,
dwKeySpec: u32,
};type
CRYPT_KEY_PROV_INFO {.bycopy.} = object
pwszContainerName: pointer
pwszProvName: pointer
dwProvType: uint32
dwFlags: uint32
cProvParam: uint32
rgProvParam: pointer
dwKeySpec: uint32struct CRYPT_KEY_PROV_INFO
{
void* pwszContainerName;
void* pwszProvName;
uint dwProvType;
uint dwFlags;
uint cProvParam;
void* rgProvParam;
uint dwKeySpec;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPT_KEY_PROV_INFO サイズ: 28 バイト(x86)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; pwszContainerName : LPWSTR (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pwszProvName : LPWSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwProvType : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwFlags : CRYPT_KEY_FLAGS (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; cProvParam : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; rgProvParam : CRYPT_KEY_PROV_PARAM* (+20, 4byte) varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; dwKeySpec : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPT_KEY_PROV_INFO サイズ: 48 バイト(x64)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; pwszContainerName : LPWSTR (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; pwszProvName : LPWSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; dwProvType : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwFlags : CRYPT_KEY_FLAGS (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; cProvParam : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; rgProvParam : CRYPT_KEY_PROV_PARAM* (+32, 8byte) varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; dwKeySpec : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPT_KEY_PROV_INFO
#field intptr pwszContainerName
#field intptr pwszProvName
#field int dwProvType
#field int dwFlags
#field int cProvParam
#field intptr rgProvParam
#field int dwKeySpec
#endstruct
stdim st, CRYPT_KEY_PROV_INFO ; NSTRUCT 変数を確保
st->dwProvType = 100
mes "dwProvType=" + st->dwProvType