Win32 API 日本語リファレンス
ホームSecurity.Cryptography › CRYPT_OID_INFO

CRYPT_OID_INFO

構造体
サイズx64: 48 バイト / x86: 28 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ (バイト単位)。
pszOIDLPSTR8/4+8+4この OID 情報に関連付けられた OID。
pwszNameLPWSTR8/4+16+8OID に関連付けられた表示名。
dwGroupIdDWORD4+24+12

この OID 情報に関連付けられたグループ識別子の値。

このメンバーには、次の dwGroupId グループ識別子のいずれかを指定できます。

意味
CRYPT_ENCRYPT_ALG_OID_GROUP_ID
暗号化アルゴリズム
CRYPT_ENHKEY_USAGE_OID_GROUP_ID
拡張キー使用法
CRYPT_EXT_OR_ATTR_OID_GROUP_ID
拡張または属性
CRYPT_HASH_ALG_OID_GROUP_ID
ハッシュアルゴリズム
CRYPT_POLICY_OID_GROUP_ID
ポリシー
CRYPT_PUBKEY_ALG_OID_GROUP_ID
公開キーアルゴリズム
CRYPT_RDN_ATTR_OID_GROUP_ID
RDN 属性
CRYPT_SIGN_ALG_OID_GROUP_ID
署名アルゴリズム
Anonymous_Anonymous_e__Union4+28+16アルゴリズム識別子や暗号化アルゴリズムなどグループ固有情報を保持する共用体。
ExtraInfoCRYPT_INTEGER_BLOB16/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_OID_INHIBIT_SIGNATURE_FORMAT_FLAG
このフラグは現在使用されていません。

CryptVerifySignature 関数が呼び出される前、または CryptSignHash 関数が呼び出された後の署名の再フォーマットを停止します。

CRYPT_OID_NO_NULL_ALGORITHM_PARA_FLAG
エンコード時に NULL パラメーターを省略します。
CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG
公開キーは暗号化にのみ使用されます。
CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG
公開キーは署名にのみ使用されます。
CRYPT_OID_USE_PUBKEY_PARA_FOR_PKCS7_FLAG
このフラグは現在使用されていません。

PKCS #7 メッセージの digestEncryptionAlgorithm パラメーターに、公開キーアルゴリズムのパラメーターを含めます。

CRYPT_OID_USE_CURVE_NAME_FOR_ENCODE_FLAG
エンコードに CNG の曲線名を使用します。
CRYPT_OID_USE_CURVE_PARAMETERS_FOR_ENCODE_FLAG
エンコードに CNG の曲線パラメーターを使用します。
CRYPT_OID_PUBKEY_PURE_ONLY_FLAG
"Pure" 署名にのみ使用すべきポスト量子キーです。
CRYPT_OID_PUBKEY_PREHASH_ONLY_FLAG
"PreHash" 署名にのみ使用すべきポスト量子キーです。PQ パラメーターセットごとに 1 つのハッシュアルゴリズムを使用します。
CRYPT_OID_COMPOSITE_ECDSA_FLAG
ポスト量子署名アルゴリズムと ECDSA 署名アルゴリズムの両方を使用する複合署名キーです。設定されている場合、署名のバイト長は最大長になります。

ポスト量子暗号での使用

CRYPT_PUBKEY_ALG_OID_GROUP_ID を (上記の) PQ OID と共に使用する場合、ExtraInfo には次のフィールドがあります。

フィールド 説明
DWORD[0] フラグ
DWORD[1] 公開マジック値 (例: BCRYPT_MLDSA_PUBLIC_MAGIC)
DWORD[2] 秘密マジック値 (例: BCRYPT_MLDSA_PRIVATE_SEED_MAGIC)
DWORD[4] 公開キーのバイト長
DWORD[5] 秘密キーのバイト長
DWORD[6] 署名のバイト長

CRYPT_SIGN_ALG_OID_GROUP_ID を PQ OID と共に使用する場合、ExtraInfo には次のフィールドがあります。

フィールド 説明
DWORD[0] フラグ
DWORD[1] 署名のバイト長

CRYPT_HASH_ALG_OID_GROUP_ID に L”NoHash” を設定すると、署名前にハッシュを行わないことを示し、PQ キーが ToBeSigned のバイト列を直接署名します。

共用体: _Anonymous_e__Union x64 4B / x86 4B

フィールドサイズx64x86説明
dwValueDWORD4+0+0この OID 情報に関連付けられた数値。このメンバーは、dwGroupIdCRYPT_SIGN_ALG_OID_GROUP_ID の場合に使用されます。
AlgidALG_ID4+0+0

この OID 情報に関連付けられたアルゴリズム識別子。

このメンバーは、dwGroupId が次の値の場合に適用されます。

dwLengthDWORD4+0+0このメンバーは実装されていません。常に 0 に設定されます。

公式ドキュメント

CRYPT_OID_INFO 構造体は、オブジェクト識別子 (OID) に関する情報を格納します。これらの構造体は、OID 識別子、その名前、そのグループ、および OID に関するその他の情報の関係を示します。これらの構造体は CryptEnumOIDInfo 関数を使用して列挙できます。新しい CRYPT_OID_STRUCTURES は CryptRegisterOIDInfo 関数を使用して追加できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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_BLOB
struct 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 非対応)。必要に応じ手動でアクセス。