ホーム › Security.Cryptography › CMSG_CTRL_DECRYPT_PARA
CMSG_CTRL_DECRYPT_PARA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 | ||||||
| Anonymous | _Anonymous_e__Union | 8/4 | +8 | +4 | 復号に使うレガシーCSPまたはCNG鍵ハンドルを保持する共用体。 | ||||||
| dwKeySpec | DWORD | 4 | +16 | +8 | 使用する秘密キーです。このメンバーは、hNCryptKey メンバーを使用する場合には使用されません。 既定のプロバイダーでは、次の dwKeySpec の値が定義されています。
dwKeySpec が 0 の場合は、既定値の AT_KEYEXCHANGE が使用されます。 | ||||||
| dwRecipientIndex | DWORD | 4 | +20 | +12 | hCryptProv の秘密キーに関連付けられた、メッセージ内の受信者のインデックスです。 |
共用体: _Anonymous_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| hCryptProv | UINT_PTR | 8/4 | +0 | +0 | 暗号化サービス プロバイダー (CSP) のハンドルです。共用体のどちらが選択されているかを判別するために、CNG 関数 NCryptIsKeyHandle が呼び出されます。 |
| hNCryptKey | NCRYPT_KEY_HANDLE | 8/4 | +0 | +0 | CNG 暗号化サービス プロバイダー (CSP) のハンドルです。共用体のどちらが選択されているかを判別するために、CNG 関数 NCryptIsKeyHandle が呼び出されます。新しい暗号化アルゴリズムは CNG 関数でのみサポートされます。必要な場合は、CryptoAPI の hCryptProv の選択を変換するために CNG 関数 NCryptTranslateHandle が呼び出されます。アプリケーションでは、NCryptOpenKey 関数から返される CNG CSP のハンドルを hNCryptKey メンバーに渡すことをお勧めします。 |
公式ドキュメント
CMSG_CTRL_DECRYPT_PARA 構造体は、キー トランスポート受信者向けにエンベロープ メッセージを復号化するために使用する情報を格納します。この構造体は、dwCtrlType パラメーターが CMSG_CTRL_DECRYPT の場合に CryptMsgControl に渡されます。
CryptoAPI が Secure/Multipurpose Internet Mail Extensions (S/MIME) 電子メールの相互運用性をどのようにサポートするかについては、 CryptMsgOpenToEncode の「解説」セクションを参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CMSG_CTRL_DECRYPT_PARA (x64 24 / x86 16 バイト)
typedef struct CMSG_CTRL_DECRYPT_PARA {
DWORD cbSize;
_Anonymous_e__Union Anonymous;
DWORD dwKeySpec;
DWORD dwRecipientIndex;
} CMSG_CTRL_DECRYPT_PARA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CMSG_CTRL_DECRYPT_PARA
{
public uint cbSize;
public _Anonymous_e__Union Anonymous;
public uint dwKeySpec;
public uint dwRecipientIndex;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CMSG_CTRL_DECRYPT_PARA
Public cbSize As UInteger
Public Anonymous As _Anonymous_e__Union
Public dwKeySpec As UInteger
Public dwRecipientIndex As UInteger
End Structureimport ctypes
from ctypes import wintypes
class CMSG_CTRL_DECRYPT_PARA(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
("dwKeySpec", wintypes.DWORD),
("dwRecipientIndex", wintypes.DWORD),
]#[repr(C)]
pub struct CMSG_CTRL_DECRYPT_PARA {
pub cbSize: u32,
pub Anonymous: _Anonymous_e__Union,
pub dwKeySpec: u32,
pub dwRecipientIndex: u32,
}import "golang.org/x/sys/windows"
type CMSG_CTRL_DECRYPT_PARA struct {
cbSize uint32
Anonymous _Anonymous_e__Union
dwKeySpec uint32
dwRecipientIndex uint32
}type
CMSG_CTRL_DECRYPT_PARA = record
cbSize: DWORD;
Anonymous: _Anonymous_e__Union;
dwKeySpec: DWORD;
dwRecipientIndex: DWORD;
end;const CMSG_CTRL_DECRYPT_PARA = extern struct {
cbSize: u32,
Anonymous: _Anonymous_e__Union,
dwKeySpec: u32,
dwRecipientIndex: u32,
};type
CMSG_CTRL_DECRYPT_PARA {.bycopy.} = object
cbSize: uint32
Anonymous: _Anonymous_e__Union
dwKeySpec: uint32
dwRecipientIndex: uint32struct CMSG_CTRL_DECRYPT_PARA
{
uint cbSize;
_Anonymous_e__Union Anonymous;
uint dwKeySpec;
uint dwRecipientIndex;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CMSG_CTRL_DECRYPT_PARA サイズ: 16 バイト(x86)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+4, 4byte) varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; dwKeySpec : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwRecipientIndex : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CMSG_CTRL_DECRYPT_PARA サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+8, 8byte) varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; dwKeySpec : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwRecipientIndex : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CMSG_CTRL_DECRYPT_PARA
#field int cbSize
#field byte Anonymous 8
#field int dwKeySpec
#field int dwRecipientIndex
#endstruct
stdim st, CMSG_CTRL_DECRYPT_PARA ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。