PUBLICKEYSTRUC
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| bType | BYTE | 1 | +0 | +0 | キー BLOB の型が格納されます。 このメンバーの定義済みの値を次に示します。暗号化サービス プロバイダー (CSP) は、必要に応じてこれ以外の型識別子を使用できます。
| ||||||||||||||||||
| bVersion | BYTE | 1 | +1 | +1 | キー BLOB 形式のバージョン番号が格納されます。たとえば、BLOB が Digital Signature Standard (DSS) バージョン 3 のキーである場合、このメンバーには 3 が格納されます。このメンバーの最小値は CUR_BLOB_VERSION (2) 識別子によって定義されます。 | ||||||||||||||||||
| reserved | WORD | 2 | +2 | +2 | このメンバーは将来の使用のために予約済みであり、0 に設定しなければなりません。 | ||||||||||||||||||
| aiKeyAlg | ALG_ID | 4 | +4 | +4 | キー BLOB に含まれるキーのアルゴリズムを識別する ALG_ID 値のいずれかが格納されます。 すべてのアルゴリズム識別子がすべての BLOB 型で有効なわけではありません。たとえば、RC4 キーはセッション キーであるため、PUBLICKEYBLOB にエクスポートすることはできません。 PLAINTEXTBLOB は、使用中の CSP がサポートする任意のアルゴリズムまたはキー種別の組み合わせで使用できます。なお、Microsoft Base Provider を使用している場合、3DES キーはインポートできません。 |
公式ドキュメント
PUBLICKEYSTRUC 構造体は BLOBHEADER 構造体とも呼ばれ、キーの BLOB 型と、そのキーが使用するアルゴリズムを示します。この構造体は、すべての キー BLOB の pbData メンバーの先頭に配置されます。
この構造体は、PROV_RSA_BASE および PROV_RSA_SIG プロバイダー型によって生成されるキー BLOB に限定されません。新しいキー BLOB 型の pbData メンバーは、必ずこの構造体で始まらなければなりません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PUBLICKEYSTRUC (x64 8 / x86 8 バイト)
typedef struct PUBLICKEYSTRUC {
BYTE bType;
BYTE bVersion;
WORD reserved;
ALG_ID aiKeyAlg;
} PUBLICKEYSTRUC;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PUBLICKEYSTRUC
{
public byte bType;
public byte bVersion;
public ushort reserved;
public uint aiKeyAlg;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PUBLICKEYSTRUC
Public bType As Byte
Public bVersion As Byte
Public reserved As UShort
Public aiKeyAlg As UInteger
End Structureimport ctypes
from ctypes import wintypes
class PUBLICKEYSTRUC(ctypes.Structure):
_fields_ = [
("bType", ctypes.c_ubyte),
("bVersion", ctypes.c_ubyte),
("reserved", ctypes.c_ushort),
("aiKeyAlg", wintypes.DWORD),
]#[repr(C)]
pub struct PUBLICKEYSTRUC {
pub bType: u8,
pub bVersion: u8,
pub reserved: u16,
pub aiKeyAlg: u32,
}import "golang.org/x/sys/windows"
type PUBLICKEYSTRUC struct {
bType byte
bVersion byte
reserved uint16
aiKeyAlg uint32
}type
PUBLICKEYSTRUC = record
bType: Byte;
bVersion: Byte;
reserved: Word;
aiKeyAlg: DWORD;
end;const PUBLICKEYSTRUC = extern struct {
bType: u8,
bVersion: u8,
reserved: u16,
aiKeyAlg: u32,
};type
PUBLICKEYSTRUC {.bycopy.} = object
bType: uint8
bVersion: uint8
reserved: uint16
aiKeyAlg: uint32struct PUBLICKEYSTRUC
{
ubyte bType;
ubyte bVersion;
ushort reserved;
uint aiKeyAlg;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PUBLICKEYSTRUC サイズ: 8 バイト(x64)
dim st, 2 ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; bType : BYTE (+0, 1byte) poke st,0,値 / 値 = peek(st,0)
; bVersion : BYTE (+1, 1byte) poke st,1,値 / 値 = peek(st,1)
; reserved : WORD (+2, 2byte) wpoke st,2,値 / 値 = wpeek(st,2)
; aiKeyAlg : ALG_ID (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PUBLICKEYSTRUC
#field byte bType
#field byte bVersion
#field short reserved
#field int aiKeyAlg
#endstruct
stdim st, PUBLICKEYSTRUC ; NSTRUCT 変数を確保
st->bType = 100
mes "bType=" + st->bType