ホーム › Security.Cryptography › CMSG_KEY_AGREE_RECIPIENT_INFO
CMSG_KEY_AGREE_RECIPIENT_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| dwVersion | DWORD | 4 | +0 | +0 | 構造体のバージョンを示す DWORD です。常に 3 に設定します。 | ||||||
| dwOriginatorChoice | CMSG_KEY_AGREE_ORIGINATOR | 4 | +4 | +4 | 使用するキー識別子を示す DWORD です。 このメンバーには次のいずれかの値を指定できます。
| ||||||
| Anonymous | _Anonymous_e__Union | 48/24 | +8 | +8 | 送信者の証明書IDまたは公開鍵情報を保持する共用体。 | ||||||
| UserKeyingMaterial | CRYPT_INTEGER_BLOB | 16/8 | +56 | +32 | 同じ 2 者がキーのペアを生成するたびに異なるキーが生成されることを示す CRYPT_DATA_BLOB です。一部のキー合意アルゴリズムでは、送信者がこの BLOB のビットを提供します。このメンバーは NULL でもかまいません。 | ||||||
| KeyEncryptionAlgorithm | CRYPT_ALGORITHM_IDENTIFIER | 24/12 | +72 | +40 | コンテンツ暗号化キーの暗号化に使用されるキー暗号化アルゴリズムと、それに関連するパラメーターを識別する CRYPT_ALGORITHM_IDENTIFIER です。 | ||||||
| cRecipientEncryptedKeys | DWORD | 4 | +96 | +52 | rgpRecipientEncryptedKeys 配列内の要素数です。 | ||||||
| rgpRecipientEncryptedKeys | CMSG_RECIPIENT_ENCRYPTED_KEY_INFO** | 8/4 | +104 | +56 | キーの受信者に関する情報を格納する CMSG_RECIPIENT_ENCRYPTED_KEY_INFO 構造体の配列のアドレスです。この配列内の要素数は cRecipientEncryptedKeys メンバーに格納されます。 |
共用体: _Anonymous_e__Union x64 48B / x86 24B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| OriginatorCertId | CERT_ID | 40/20 | +0 | +0 | メッセージ発信元の公開キーを識別する CERT_ID です。 |
| OriginatorPublicKeyInfo | CERT_PUBLIC_KEY_INFO | 48/24 | +0 | +0 | メッセージ発信元の公開キーを格納する CERT_PUBLIC_KEY_INFO 構造体です。 |
公式ドキュメント
CMSG_KEY_AGREE_RECIPIENT_INFO 構造体は、キー合意アルゴリズムで使用される情報を格納します。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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>
// CRYPT_INTEGER_BLOB (x64 16 / x86 8 バイト)
typedef struct CRYPT_INTEGER_BLOB {
DWORD cbData;
BYTE* pbData;
} CRYPT_INTEGER_BLOB;
// CRYPT_ALGORITHM_IDENTIFIER (x64 24 / x86 12 バイト)
typedef struct CRYPT_ALGORITHM_IDENTIFIER {
LPSTR pszObjId;
CRYPT_INTEGER_BLOB Parameters;
} CRYPT_ALGORITHM_IDENTIFIER;
// CMSG_KEY_AGREE_RECIPIENT_INFO (x64 112 / x86 60 バイト)
typedef struct CMSG_KEY_AGREE_RECIPIENT_INFO {
DWORD dwVersion;
CMSG_KEY_AGREE_ORIGINATOR dwOriginatorChoice;
_Anonymous_e__Union Anonymous;
CRYPT_INTEGER_BLOB UserKeyingMaterial;
CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
DWORD cRecipientEncryptedKeys;
CMSG_RECIPIENT_ENCRYPTED_KEY_INFO** rgpRecipientEncryptedKeys;
} CMSG_KEY_AGREE_RECIPIENT_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_INTEGER_BLOB
{
public uint cbData;
public IntPtr pbData;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_ALGORITHM_IDENTIFIER
{
public IntPtr pszObjId;
public CRYPT_INTEGER_BLOB Parameters;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CMSG_KEY_AGREE_RECIPIENT_INFO
{
public uint dwVersion;
public uint dwOriginatorChoice;
public _Anonymous_e__Union Anonymous;
public CRYPT_INTEGER_BLOB UserKeyingMaterial;
public CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
public uint cRecipientEncryptedKeys;
public IntPtr rgpRecipientEncryptedKeys;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPT_INTEGER_BLOB
Public cbData As UInteger
Public pbData As IntPtr
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPT_ALGORITHM_IDENTIFIER
Public pszObjId As IntPtr
Public Parameters As CRYPT_INTEGER_BLOB
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CMSG_KEY_AGREE_RECIPIENT_INFO
Public dwVersion As UInteger
Public dwOriginatorChoice As UInteger
Public Anonymous As _Anonymous_e__Union
Public UserKeyingMaterial As CRYPT_INTEGER_BLOB
Public KeyEncryptionAlgorithm As CRYPT_ALGORITHM_IDENTIFIER
Public cRecipientEncryptedKeys As UInteger
Public rgpRecipientEncryptedKeys As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class CRYPT_INTEGER_BLOB(ctypes.Structure):
_fields_ = [
("cbData", wintypes.DWORD),
("pbData", ctypes.c_void_p),
]
class CRYPT_ALGORITHM_IDENTIFIER(ctypes.Structure):
_fields_ = [
("pszObjId", ctypes.c_void_p),
("Parameters", CRYPT_INTEGER_BLOB),
]
class CMSG_KEY_AGREE_RECIPIENT_INFO(ctypes.Structure):
_fields_ = [
("dwVersion", wintypes.DWORD),
("dwOriginatorChoice", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
("UserKeyingMaterial", CRYPT_INTEGER_BLOB),
("KeyEncryptionAlgorithm", CRYPT_ALGORITHM_IDENTIFIER),
("cRecipientEncryptedKeys", wintypes.DWORD),
("rgpRecipientEncryptedKeys", ctypes.c_void_p),
]#[repr(C)]
pub struct CRYPT_INTEGER_BLOB {
pub cbData: u32,
pub pbData: *mut core::ffi::c_void,
}
#[repr(C)]
pub struct CRYPT_ALGORITHM_IDENTIFIER {
pub pszObjId: *mut core::ffi::c_void,
pub Parameters: CRYPT_INTEGER_BLOB,
}
#[repr(C)]
pub struct CMSG_KEY_AGREE_RECIPIENT_INFO {
pub dwVersion: u32,
pub dwOriginatorChoice: u32,
pub Anonymous: _Anonymous_e__Union,
pub UserKeyingMaterial: CRYPT_INTEGER_BLOB,
pub KeyEncryptionAlgorithm: CRYPT_ALGORITHM_IDENTIFIER,
pub cRecipientEncryptedKeys: u32,
pub rgpRecipientEncryptedKeys: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type CRYPT_INTEGER_BLOB struct {
cbData uint32
pbData uintptr
}
type CRYPT_ALGORITHM_IDENTIFIER struct {
pszObjId uintptr
Parameters CRYPT_INTEGER_BLOB
}
type CMSG_KEY_AGREE_RECIPIENT_INFO struct {
dwVersion uint32
dwOriginatorChoice uint32
Anonymous _Anonymous_e__Union
UserKeyingMaterial CRYPT_INTEGER_BLOB
KeyEncryptionAlgorithm CRYPT_ALGORITHM_IDENTIFIER
cRecipientEncryptedKeys uint32
rgpRecipientEncryptedKeys uintptr
}type
CRYPT_INTEGER_BLOB = record
cbData: DWORD;
pbData: Pointer;
end;
CRYPT_ALGORITHM_IDENTIFIER = record
pszObjId: Pointer;
Parameters: CRYPT_INTEGER_BLOB;
end;
CMSG_KEY_AGREE_RECIPIENT_INFO = record
dwVersion: DWORD;
dwOriginatorChoice: DWORD;
Anonymous: _Anonymous_e__Union;
UserKeyingMaterial: CRYPT_INTEGER_BLOB;
KeyEncryptionAlgorithm: CRYPT_ALGORITHM_IDENTIFIER;
cRecipientEncryptedKeys: DWORD;
rgpRecipientEncryptedKeys: Pointer;
end;const CRYPT_INTEGER_BLOB = extern struct {
cbData: u32,
pbData: ?*anyopaque,
};
const CRYPT_ALGORITHM_IDENTIFIER = extern struct {
pszObjId: ?*anyopaque,
Parameters: CRYPT_INTEGER_BLOB,
};
const CMSG_KEY_AGREE_RECIPIENT_INFO = extern struct {
dwVersion: u32,
dwOriginatorChoice: u32,
Anonymous: _Anonymous_e__Union,
UserKeyingMaterial: CRYPT_INTEGER_BLOB,
KeyEncryptionAlgorithm: CRYPT_ALGORITHM_IDENTIFIER,
cRecipientEncryptedKeys: u32,
rgpRecipientEncryptedKeys: ?*anyopaque,
};type
CRYPT_INTEGER_BLOB {.bycopy.} = object
cbData: uint32
pbData: pointer
CRYPT_ALGORITHM_IDENTIFIER {.bycopy.} = object
pszObjId: pointer
Parameters: CRYPT_INTEGER_BLOB
CMSG_KEY_AGREE_RECIPIENT_INFO {.bycopy.} = object
dwVersion: uint32
dwOriginatorChoice: uint32
Anonymous: _Anonymous_e__Union
UserKeyingMaterial: CRYPT_INTEGER_BLOB
KeyEncryptionAlgorithm: CRYPT_ALGORITHM_IDENTIFIER
cRecipientEncryptedKeys: uint32
rgpRecipientEncryptedKeys: pointerstruct CRYPT_INTEGER_BLOB
{
uint cbData;
void* pbData;
}
struct CRYPT_ALGORITHM_IDENTIFIER
{
void* pszObjId;
CRYPT_INTEGER_BLOB Parameters;
}
struct CMSG_KEY_AGREE_RECIPIENT_INFO
{
uint dwVersion;
uint dwOriginatorChoice;
_Anonymous_e__Union Anonymous;
CRYPT_INTEGER_BLOB UserKeyingMaterial;
CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
uint cRecipientEncryptedKeys;
void* rgpRecipientEncryptedKeys;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CMSG_KEY_AGREE_RECIPIENT_INFO サイズ: 60 バイト(x86)
dim st, 15 ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwOriginatorChoice : CMSG_KEY_AGREE_ORIGINATOR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+8, 24byte) varptr(st)+8 を基点に操作(24byte:入れ子/配列)
; UserKeyingMaterial : CRYPT_INTEGER_BLOB (+32, 8byte) varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; KeyEncryptionAlgorithm : CRYPT_ALGORITHM_IDENTIFIER (+40, 12byte) varptr(st)+40 を基点に操作(12byte:入れ子/配列)
; cRecipientEncryptedKeys : DWORD (+52, 4byte) st.13 = 値 / 値 = st.13 (lpoke/lpeek も可)
; rgpRecipientEncryptedKeys : CMSG_RECIPIENT_ENCRYPTED_KEY_INFO** (+56, 4byte) varptr(st)+56 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CMSG_KEY_AGREE_RECIPIENT_INFO サイズ: 112 バイト(x64)
dim st, 28 ; 4byte整数×28(構造体サイズ 112 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwOriginatorChoice : CMSG_KEY_AGREE_ORIGINATOR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+8, 48byte) varptr(st)+8 を基点に操作(48byte:入れ子/配列)
; UserKeyingMaterial : CRYPT_INTEGER_BLOB (+56, 16byte) varptr(st)+56 を基点に操作(16byte:入れ子/配列)
; KeyEncryptionAlgorithm : CRYPT_ALGORITHM_IDENTIFIER (+72, 24byte) varptr(st)+72 を基点に操作(24byte:入れ子/配列)
; cRecipientEncryptedKeys : DWORD (+96, 4byte) st.24 = 値 / 値 = st.24 (lpoke/lpeek も可)
; rgpRecipientEncryptedKeys : CMSG_RECIPIENT_ENCRYPTED_KEY_INFO** (+104, 8byte) varptr(st)+104 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global CRYPT_INTEGER_BLOB
#field int cbData
#field intptr pbData
#endstruct
#defstruct global CRYPT_ALGORITHM_IDENTIFIER
#field intptr pszObjId
#field CRYPT_INTEGER_BLOB Parameters
#endstruct
#defstruct global CMSG_KEY_AGREE_RECIPIENT_INFO
#field int dwVersion
#field int dwOriginatorChoice
#field byte Anonymous 48
#field CRYPT_INTEGER_BLOB UserKeyingMaterial
#field CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm
#field int cRecipientEncryptedKeys
#field intptr rgpRecipientEncryptedKeys
#endstruct
stdim st, CMSG_KEY_AGREE_RECIPIENT_INFO ; NSTRUCT 変数を確保
st->dwVersion = 100
mes "dwVersion=" + st->dwVersion
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。