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

CRL_INFO

構造体
サイズx64: 96 バイト / x86: 56 バイト

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

フィールド

フィールドサイズx64x86説明
dwVersionDWORD4+0+0

CRL のバージョン番号です。現在定義されているバージョン番号は次の表のとおりです。

意味
CRL_V1
バージョン 1
CRL_V2
バージョン 2
SignatureAlgorithmCRYPT_ALGORITHM_IDENTIFIER24/12+8+4署名アルゴリズムのオブジェクト識別子 (OID) と、それに関連する追加のパラメーターを格納する CRYPT_ALGORITHM_IDENTIFIER 構造体です。
IssuerCRYPT_INTEGER_BLOB16/8+32+16エンコードされた証明書発行者の名前を格納する BLOB 構造体です。
ThisUpdateFILETIME8+48+24CRL が発行された日時を示します。時刻が 1950 年より後かつ 2050 年より前の場合は、2 桁の年で秒単位まで表す 8 バイトの日付/時刻 (つまり YYMMDDHHMMSS に 2 バイトを加えたもの) として UTC 時刻でエンコードされます。それ以外の場合は、4 バイトの年を使用し、ミリ秒単位まで表す一般化時刻 (generalized time) としてエンコードされます。
NextUpdateFILETIME8+56+32CRL の次回の更新予定日時を示します。時刻が 1950 年より後かつ 2050 年より前の場合は、2 桁の年で秒単位まで表す 8 バイトの日付/時刻 (つまり YYMMDDHHMMSS に 2 バイトを加えたもの) として UTC 時刻でエンコードされます。それ以外の場合は、4 バイトの年を使用し、ミリ秒単位まで表す一般化時刻 (generalized time) としてエンコードされます。
cCRLEntryDWORD4+64+40rgCRLEntry 配列の要素数です。
rgCRLEntryCRL_ENTRY*8/4+72+44CRL_ENTRY 構造体へのポインターの配列です。これらの構造体は、それぞれ失効した証明書を表します。
cExtensionDWORD4+80+48rgExtension 配列の要素数です。
rgExtensionCERT_EXTENSION*8/4+88+52CERT_EXTENSION 構造体へのポインターの配列です。各構造体は、CRL に関する情報を保持します。

公式ドキュメント

CRL_INFO 構造体は、証明書失効リスト (CRL) の情報を格納します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ALGORITHM_IDENTIFIER  (x64 24 / x86 12 バイト)
typedef struct CRYPT_ALGORITHM_IDENTIFIER {
    LPSTR pszObjId;
    CRYPT_INTEGER_BLOB Parameters;
} CRYPT_ALGORITHM_IDENTIFIER;

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// CRL_INFO  (x64 96 / x86 56 バイト)
typedef struct CRL_INFO {
    DWORD dwVersion;
    CRYPT_ALGORITHM_IDENTIFIER SignatureAlgorithm;
    CRYPT_INTEGER_BLOB Issuer;
    FILETIME ThisUpdate;
    FILETIME NextUpdate;
    DWORD cCRLEntry;
    CRL_ENTRY* rgCRLEntry;
    DWORD cExtension;
    CERT_EXTENSION* rgExtension;
} CRL_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 FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRL_INFO
{
    public uint dwVersion;
    public CRYPT_ALGORITHM_IDENTIFIER SignatureAlgorithm;
    public CRYPT_INTEGER_BLOB Issuer;
    public FILETIME ThisUpdate;
    public FILETIME NextUpdate;
    public uint cCRLEntry;
    public IntPtr rgCRLEntry;
    public uint cExtension;
    public IntPtr rgExtension;
}
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 FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRL_INFO
    Public dwVersion As UInteger
    Public SignatureAlgorithm As CRYPT_ALGORITHM_IDENTIFIER
    Public Issuer As CRYPT_INTEGER_BLOB
    Public ThisUpdate As FILETIME
    Public NextUpdate As FILETIME
    Public cCRLEntry As UInteger
    Public rgCRLEntry As IntPtr
    Public cExtension As UInteger
    Public rgExtension As IntPtr
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_ALGORITHM_IDENTIFIER(ctypes.Structure):
    _fields_ = [
        ("pszObjId", ctypes.c_void_p),
        ("Parameters", CRYPT_INTEGER_BLOB),
    ]

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class CRL_INFO(ctypes.Structure):
    _fields_ = [
        ("dwVersion", wintypes.DWORD),
        ("SignatureAlgorithm", CRYPT_ALGORITHM_IDENTIFIER),
        ("Issuer", CRYPT_INTEGER_BLOB),
        ("ThisUpdate", FILETIME),
        ("NextUpdate", FILETIME),
        ("cCRLEntry", wintypes.DWORD),
        ("rgCRLEntry", ctypes.c_void_p),
        ("cExtension", wintypes.DWORD),
        ("rgExtension", 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 FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct CRL_INFO {
    pub dwVersion: u32,
    pub SignatureAlgorithm: CRYPT_ALGORITHM_IDENTIFIER,
    pub Issuer: CRYPT_INTEGER_BLOB,
    pub ThisUpdate: FILETIME,
    pub NextUpdate: FILETIME,
    pub cCRLEntry: u32,
    pub rgCRLEntry: *mut core::ffi::c_void,
    pub cExtension: u32,
    pub rgExtension: *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 FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type CRL_INFO struct {
	dwVersion uint32
	SignatureAlgorithm CRYPT_ALGORITHM_IDENTIFIER
	Issuer CRYPT_INTEGER_BLOB
	ThisUpdate FILETIME
	NextUpdate FILETIME
	cCRLEntry uint32
	rgCRLEntry uintptr
	cExtension uint32
	rgExtension uintptr
}
type
  CRYPT_INTEGER_BLOB = record
    cbData: DWORD;
    pbData: Pointer;
  end;

  CRYPT_ALGORITHM_IDENTIFIER = record
    pszObjId: Pointer;
    Parameters: CRYPT_INTEGER_BLOB;
  end;

  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  CRL_INFO = record
    dwVersion: DWORD;
    SignatureAlgorithm: CRYPT_ALGORITHM_IDENTIFIER;
    Issuer: CRYPT_INTEGER_BLOB;
    ThisUpdate: FILETIME;
    NextUpdate: FILETIME;
    cCRLEntry: DWORD;
    rgCRLEntry: Pointer;
    cExtension: DWORD;
    rgExtension: 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 FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const CRL_INFO = extern struct {
    dwVersion: u32,
    SignatureAlgorithm: CRYPT_ALGORITHM_IDENTIFIER,
    Issuer: CRYPT_INTEGER_BLOB,
    ThisUpdate: FILETIME,
    NextUpdate: FILETIME,
    cCRLEntry: u32,
    rgCRLEntry: ?*anyopaque,
    cExtension: u32,
    rgExtension: ?*anyopaque,
};
type
  CRYPT_INTEGER_BLOB {.bycopy.} = object
    cbData: uint32
    pbData: pointer

  CRYPT_ALGORITHM_IDENTIFIER {.bycopy.} = object
    pszObjId: pointer
    Parameters: CRYPT_INTEGER_BLOB

  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  CRL_INFO {.bycopy.} = object
    dwVersion: uint32
    SignatureAlgorithm: CRYPT_ALGORITHM_IDENTIFIER
    Issuer: CRYPT_INTEGER_BLOB
    ThisUpdate: FILETIME
    NextUpdate: FILETIME
    cCRLEntry: uint32
    rgCRLEntry: pointer
    cExtension: uint32
    rgExtension: pointer
struct CRYPT_INTEGER_BLOB
{
    uint cbData;
    void* pbData;
}

struct CRYPT_ALGORITHM_IDENTIFIER
{
    void* pszObjId;
    CRYPT_INTEGER_BLOB Parameters;
}

struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct CRL_INFO
{
    uint dwVersion;
    CRYPT_ALGORITHM_IDENTIFIER SignatureAlgorithm;
    CRYPT_INTEGER_BLOB Issuer;
    FILETIME ThisUpdate;
    FILETIME NextUpdate;
    uint cCRLEntry;
    void* rgCRLEntry;
    uint cExtension;
    void* rgExtension;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRL_INFO サイズ: 56 バイト(x86)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; SignatureAlgorithm : CRYPT_ALGORITHM_IDENTIFIER (+4, 12byte)  varptr(st)+4 を基点に操作(12byte:入れ子/配列)
; Issuer : CRYPT_INTEGER_BLOB (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; ThisUpdate : FILETIME (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; NextUpdate : FILETIME (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; cCRLEntry : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; rgCRLEntry : CRL_ENTRY* (+44, 4byte)  varptr(st)+44 を基点に操作(4byte:入れ子/配列)
; cExtension : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; rgExtension : CERT_EXTENSION* (+52, 4byte)  varptr(st)+52 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRL_INFO サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; SignatureAlgorithm : CRYPT_ALGORITHM_IDENTIFIER (+8, 24byte)  varptr(st)+8 を基点に操作(24byte:入れ子/配列)
; Issuer : CRYPT_INTEGER_BLOB (+32, 16byte)  varptr(st)+32 を基点に操作(16byte:入れ子/配列)
; ThisUpdate : FILETIME (+48, 8byte)  varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; NextUpdate : FILETIME (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; cCRLEntry : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; rgCRLEntry : CRL_ENTRY* (+72, 8byte)  varptr(st)+72 を基点に操作(8byte:入れ子/配列)
; cExtension : DWORD (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; rgExtension : CERT_EXTENSION* (+88, 8byte)  varptr(st)+88 を基点に操作(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 FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global CRL_INFO
    #field int dwVersion
    #field CRYPT_ALGORITHM_IDENTIFIER SignatureAlgorithm
    #field CRYPT_INTEGER_BLOB Issuer
    #field FILETIME ThisUpdate
    #field FILETIME NextUpdate
    #field int cCRLEntry
    #field intptr rgCRLEntry
    #field int cExtension
    #field intptr rgExtension
#endstruct

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