CRYPT_OID_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 | ||||||||||||||||||||||||||||||||||||||||||
| pszOID | LPSTR | 8/4 | +8 | +4 | この OID 情報に関連付けられた OID。 | ||||||||||||||||||||||||||||||||||||||||||
| pwszName | LPWSTR | 8/4 | +16 | +8 | OID に関連付けられた表示名。 | ||||||||||||||||||||||||||||||||||||||||||
| dwGroupId | DWORD | 4 | +24 | +12 | この OID 情報に関連付けられたグループ識別子の値。 このメンバーには、次の dwGroupId グループ識別子のいずれかを指定できます。
| ||||||||||||||||||||||||||||||||||||||||||
| Anonymous | _Anonymous_e__Union | 4 | +28 | +16 | アルゴリズム識別子や暗号化アルゴリズムなどグループ固有情報を保持する共用体。 | ||||||||||||||||||||||||||||||||||||||||||
| ExtraInfo | CRYPT_INTEGER_BLOB | 16/8 | +32 | +20 | OID 情報の検索または登録に使用される追加情報。このメンバーは、dwGroupId が次の値の場合に適用されます。 CRYPT_ENCRYPT_ALG_OID_GROUP_ID OID グループの OID では、AES アルゴリズムのビット長が ExtraInfo メンバーの DWORD[0] メンバーに設定されます。 CRYPT_PUBKEY_ALG_OID_GROUP_ID グループの OID では、ExtraInfo メンバーの DWORD[0] メンバーにフラグが設定されます。 ECC 曲線名の公開キー (たとえば szOID_ECC_CURVE_P256 ("1.2.840.10045.3.1.7")) の OID では、ExtraInfo メンバーの DWORD[0] メンバーにフラグ、DWORD[1] メンバーに BCRYPT_ECCKEY_BLOB の dwMagic フィールドの値、DWORD[2] メンバーに BCRYPT_ECCKEY_BLOB の cbKey 値が dwBitLength / 8 + ((dwBitLength % 8) ? 1 : 0) と等しくなるビット長が設定されます。 CRYPT_SIGN_ALG_OID_GROUP_ID グループの OID では、ExtraInfo メンバーの DWORD[0] メンバーに公開キーアルゴリズム識別子、DWORD[1] メンバーにフラグ、DWORD[2] メンバーに省略可能なプロバイダーの種類が設定されます。 CRYPT_RDN_ATTR_OID_GROUP_ID グループの OID では、使用可能な RDN 属性値の型を並べた NULL 終端のリストが、ExtraInfo メンバー内の DWORD 値の配列として設定されます。リストが省略された場合は、配列の 1 番目の値が CERT_RDN_PRINTABLE_STRING、2 番目の値が CERT_RDN_UNICODE_STRING、3 番目の値が 0 である配列が指定されたものと見なされます。 ExtraInfo メンバーのフラグには、次の値が使用されます。
ポスト量子暗号での使用CRYPT_PUBKEY_ALG_OID_GROUP_ID を (上記の) PQ OID と共に使用する場合、ExtraInfo には次のフィールドがあります。
CRYPT_SIGN_ALG_OID_GROUP_ID を PQ OID と共に使用する場合、ExtraInfo には次のフィールドがあります。
CRYPT_HASH_ALG_OID_GROUP_ID に L”NoHash” を設定すると、署名前にハッシュを行わないことを示し、PQ キーが ToBeSigned のバイト列を直接署名します。 |
共用体: _Anonymous_e__Union x64 4B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwValue | DWORD | 4 | +0 | +0 | この OID 情報に関連付けられた数値。このメンバーは、dwGroupId が CRYPT_SIGN_ALG_OID_GROUP_ID の場合に使用されます。 |
| Algid | ALG_ID | 4 | +0 | +0 | この OID 情報に関連付けられたアルゴリズム識別子。 このメンバーは、dwGroupId が次の値の場合に適用されます。 |
| dwLength | DWORD | 4 | +0 | +0 | このメンバーは実装されていません。常に 0 に設定されます。 |
公式ドキュメント
CRYPT_OID_INFO 構造体は、オブジェクト識別子 (OID) に関する情報を格納します。これらの構造体は、OID 識別子、その名前、そのグループ、および OID に関するその他の情報の関係を示します。これらの構造体は CryptEnumOIDInfo 関数を使用して列挙できます。新しい CRYPT_OID_STRUCTURES は CryptRegisterOIDInfo 関数を使用して追加できます。
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_OID_INFO (x64 48 / x86 28 バイト)
typedef struct CRYPT_OID_INFO {
DWORD cbSize;
LPSTR pszOID;
LPWSTR pwszName;
DWORD dwGroupId;
_Anonymous_e__Union Anonymous;
CRYPT_INTEGER_BLOB ExtraInfo;
} CRYPT_OID_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_OID_INFO
{
public uint cbSize;
public IntPtr pszOID;
public IntPtr pwszName;
public uint dwGroupId;
public _Anonymous_e__Union Anonymous;
public CRYPT_INTEGER_BLOB ExtraInfo;
}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_OID_INFO
Public cbSize As UInteger
Public pszOID As IntPtr
Public pwszName As IntPtr
Public dwGroupId As UInteger
Public Anonymous As _Anonymous_e__Union
Public ExtraInfo As CRYPT_INTEGER_BLOB
End Structureimport ctypes
from ctypes import wintypes
class CRYPT_INTEGER_BLOB(ctypes.Structure):
_fields_ = [
("cbData", wintypes.DWORD),
("pbData", ctypes.c_void_p),
]
class CRYPT_OID_INFO(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("pszOID", ctypes.c_void_p),
("pwszName", ctypes.c_void_p),
("dwGroupId", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
("ExtraInfo", CRYPT_INTEGER_BLOB),
]#[repr(C)]
pub struct CRYPT_INTEGER_BLOB {
pub cbData: u32,
pub pbData: *mut core::ffi::c_void,
}
#[repr(C)]
pub struct CRYPT_OID_INFO {
pub cbSize: u32,
pub pszOID: *mut core::ffi::c_void,
pub pwszName: *mut core::ffi::c_void,
pub dwGroupId: u32,
pub Anonymous: _Anonymous_e__Union,
pub ExtraInfo: CRYPT_INTEGER_BLOB,
}import "golang.org/x/sys/windows"
type CRYPT_INTEGER_BLOB struct {
cbData uint32
pbData uintptr
}
type CRYPT_OID_INFO struct {
cbSize uint32
pszOID uintptr
pwszName uintptr
dwGroupId uint32
Anonymous _Anonymous_e__Union
ExtraInfo CRYPT_INTEGER_BLOB
}type
CRYPT_INTEGER_BLOB = record
cbData: DWORD;
pbData: Pointer;
end;
CRYPT_OID_INFO = record
cbSize: DWORD;
pszOID: Pointer;
pwszName: Pointer;
dwGroupId: DWORD;
Anonymous: _Anonymous_e__Union;
ExtraInfo: CRYPT_INTEGER_BLOB;
end;const CRYPT_INTEGER_BLOB = extern struct {
cbData: u32,
pbData: ?*anyopaque,
};
const CRYPT_OID_INFO = extern struct {
cbSize: u32,
pszOID: ?*anyopaque,
pwszName: ?*anyopaque,
dwGroupId: u32,
Anonymous: _Anonymous_e__Union,
ExtraInfo: CRYPT_INTEGER_BLOB,
};type
CRYPT_INTEGER_BLOB {.bycopy.} = object
cbData: uint32
pbData: pointer
CRYPT_OID_INFO {.bycopy.} = object
cbSize: uint32
pszOID: pointer
pwszName: pointer
dwGroupId: uint32
Anonymous: _Anonymous_e__Union
ExtraInfo: CRYPT_INTEGER_BLOBstruct CRYPT_INTEGER_BLOB
{
uint cbData;
void* pbData;
}
struct CRYPT_OID_INFO
{
uint cbSize;
void* pszOID;
void* pwszName;
uint dwGroupId;
_Anonymous_e__Union Anonymous;
CRYPT_INTEGER_BLOB ExtraInfo;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPT_OID_INFO サイズ: 28 バイト(x86)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pszOID : LPSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; pwszName : LPWSTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwGroupId : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+16, 4byte) varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; ExtraInfo : CRYPT_INTEGER_BLOB (+20, 8byte) varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPT_OID_INFO サイズ: 48 バイト(x64)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pszOID : LPSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pwszName : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; dwGroupId : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; Anonymous : _Anonymous_e__Union (+28, 4byte) varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; ExtraInfo : CRYPT_INTEGER_BLOB (+32, 16byte) varptr(st)+32 を基点に操作(16byte:入れ子/配列)
; ※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_OID_INFO
#field int cbSize
#field intptr pszOID
#field intptr pwszName
#field int dwGroupId
#field byte Anonymous 4
#field CRYPT_INTEGER_BLOB ExtraInfo
#endstruct
stdim st, CRYPT_OID_INFO ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。