ホーム › Security.Cryptography › BCRYPT_OID_LIST

BCRYPT_OID_LIST

構造体

サイズx64: 16 バイト / x86: 8 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
dwOIDCount	DWORD	4	+0	+0	pOIDs 配列の要素数です。
pOIDs	BCRYPT_OID*	8/4	+8	+4	OID を格納する BCRYPT_OID 構造体の配列のアドレスです。

公式ドキュメント

BCRYPT_OID_LIST 構造体は、BCRYPT_OID 構造体のコレクションを格納するために使用されます。この構造体を BCRYPT_HASH_OID_LIST プロパティと共に使用して、Distinguished Encoding Rules (DER) エンコードによってエンコードされたハッシュのオブジェクト識別子 (OID) の一覧を取得します。

解説(Remarks)

pOIDs 配列の最初の OID は、このアルゴリズムプロバイダーによって作成されたハッシュまたは署名を識別するために使用されます。ハッシュまたは署名を検証する際は、配列内のすべての OID が有効なものとして扱われます。

Microsoft Primitive Provider の実装では dwOIDCount は 2 であるため、pOIDs 配列には次の 2 つのメンバーが含まれます。

pOIDs[0] には、NULL パラメーターを持つ DER エンコードされた AlgorithmIdentifier が格納されます。
pOIDs[1] には、NULL パラメーターを持たない DER エンコードされた AlgorithmIdentifier が格納されます。

たとえば、SHA-1 のエンコードは次のようになります。

pOIDs[0] --> 06 05 2b 0e 03 02 1a 05 00
pOIDs[1] --> 06 05 2b 0e 03 02 1a

次のスニペットは、Abstract Syntax Notation One (ASN.1) 表記による AlgorithmIdentifier を示しています。SEQUENCE、OBJECT IDENTIFIER、ANY は DER エンコードされます。ANY BLOB は NULL です。

AlgorithmIdentifier ::= SEQUENCE {
   algorithm            OBJECT IDENTIFIER,
   algorithmParams      ANY
}

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// BCRYPT_OID_LIST  (x64 16 / x86 8 バイト)
typedef struct BCRYPT_OID_LIST {
    DWORD dwOIDCount;
    BCRYPT_OID* pOIDs;
} BCRYPT_OID_LIST;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct BCRYPT_OID_LIST
{
    public uint dwOIDCount;
    public IntPtr pOIDs;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure BCRYPT_OID_LIST
    Public dwOIDCount As UInteger
    Public pOIDs As IntPtr
End Structure

import ctypes
from ctypes import wintypes

class BCRYPT_OID_LIST(ctypes.Structure):
    _fields_ = [
        ("dwOIDCount", wintypes.DWORD),
        ("pOIDs", ctypes.c_void_p),
    ]

#[repr(C)]
pub struct BCRYPT_OID_LIST {
    pub dwOIDCount: u32,
    pub pOIDs: *mut core::ffi::c_void,
}

import "golang.org/x/sys/windows"

type BCRYPT_OID_LIST struct {
	dwOIDCount uint32
	pOIDs uintptr
}

type
  BCRYPT_OID_LIST = record
    dwOIDCount: DWORD;
    pOIDs: Pointer;
  end;

const BCRYPT_OID_LIST = extern struct {
    dwOIDCount: u32,
    pOIDs: ?*anyopaque,
};

type
  BCRYPT_OID_LIST {.bycopy.} = object
    dwOIDCount: uint32
    pOIDs: pointer

struct BCRYPT_OID_LIST
{
    uint dwOIDCount;
    void* pOIDs;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; BCRYPT_OID_LIST サイズ: 8 バイト(x86)
dim st, 2    ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; dwOIDCount : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pOIDs : BCRYPT_OID* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; BCRYPT_OID_LIST サイズ: 16 バイト(x64)
dim st, 4    ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; dwOIDCount : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pOIDs : BCRYPT_OID* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global BCRYPT_OID_LIST
    #field int dwOIDCount
    #field intptr pOIDs
#endstruct

stdim st, BCRYPT_OID_LIST        ; NSTRUCT 変数を確保
st->dwOIDCount = 100
mes "dwOIDCount=" + st->dwOIDCount