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

CTL_INFO

構造体
サイズx64: 128 バイト / x86: 72 バイト

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

フィールド

フィールドサイズx64x86説明
dwVersionDWORD4+0+0証明書信頼リスト(CTL)のバージョン番号。
SubjectUsageCTL_USAGE16/8+8+4CTL対象の用途(CTL_USAGE)。
ListIdentifierCRYPT_INTEGER_BLOB16/8+24+12リスト識別子BLOB。CTLを一意に識別する。任意。
SequenceNumberCRYPT_INTEGER_BLOB16/8+40+20CTLのシーケンス番号(整数BLOB)。任意。
ThisUpdateFILETIME8+56+28このCTLの発行日時(FILETIME)。
NextUpdateFILETIME8+64+36次回CTL更新予定日時(FILETIME)。
SubjectAlgorithmCRYPT_ALGORITHM_IDENTIFIER24/12+72+44主体識別子の算出に用いたアルゴリズム識別情報。
cCTLEntryDWORD4+96+56CTLエントリの個数。
rgCTLEntryCTL_ENTRY*8/4+104+60CTL_ENTRY構造体の配列へのポインタ。
cExtensionDWORD4+112+64CTL拡張の個数。
rgExtensionCERT_EXTENSION*8/4+120+68CERT_EXTENSION構造体の配列へのポインタ。

各言語での定義

#include <windows.h>

// CTL_USAGE  (x64 16 / x86 8 バイト)
typedef struct CTL_USAGE {
    DWORD cUsageIdentifier;
    LPSTR* rgpszUsageIdentifier;
} CTL_USAGE;

// CRYPT_INTEGER_BLOB  (x64 16 / x86 8 バイト)
typedef struct CRYPT_INTEGER_BLOB {
    DWORD cbData;
    BYTE* pbData;
} CRYPT_INTEGER_BLOB;

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

// CRYPT_ALGORITHM_IDENTIFIER  (x64 24 / x86 12 バイト)
typedef struct CRYPT_ALGORITHM_IDENTIFIER {
    LPSTR pszObjId;
    CRYPT_INTEGER_BLOB Parameters;
} CRYPT_ALGORITHM_IDENTIFIER;

// CTL_INFO  (x64 128 / x86 72 バイト)
typedef struct CTL_INFO {
    DWORD dwVersion;
    CTL_USAGE SubjectUsage;
    CRYPT_INTEGER_BLOB ListIdentifier;
    CRYPT_INTEGER_BLOB SequenceNumber;
    FILETIME ThisUpdate;
    FILETIME NextUpdate;
    CRYPT_ALGORITHM_IDENTIFIER SubjectAlgorithm;
    DWORD cCTLEntry;
    CTL_ENTRY* rgCTLEntry;
    DWORD cExtension;
    CERT_EXTENSION* rgExtension;
} CTL_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CTL_USAGE
{
    public uint cUsageIdentifier;
    public IntPtr rgpszUsageIdentifier;
}

[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 FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[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 CTL_INFO
{
    public uint dwVersion;
    public CTL_USAGE SubjectUsage;
    public CRYPT_INTEGER_BLOB ListIdentifier;
    public CRYPT_INTEGER_BLOB SequenceNumber;
    public FILETIME ThisUpdate;
    public FILETIME NextUpdate;
    public CRYPT_ALGORITHM_IDENTIFIER SubjectAlgorithm;
    public uint cCTLEntry;
    public IntPtr rgCTLEntry;
    public uint cExtension;
    public IntPtr rgExtension;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CTL_USAGE
    Public cUsageIdentifier As UInteger
    Public rgpszUsageIdentifier As IntPtr
End Structure

<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 FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
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 CTL_INFO
    Public dwVersion As UInteger
    Public SubjectUsage As CTL_USAGE
    Public ListIdentifier As CRYPT_INTEGER_BLOB
    Public SequenceNumber As CRYPT_INTEGER_BLOB
    Public ThisUpdate As FILETIME
    Public NextUpdate As FILETIME
    Public SubjectAlgorithm As CRYPT_ALGORITHM_IDENTIFIER
    Public cCTLEntry As UInteger
    Public rgCTLEntry As IntPtr
    Public cExtension As UInteger
    Public rgExtension As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class CTL_USAGE(ctypes.Structure):
    _fields_ = [
        ("cUsageIdentifier", wintypes.DWORD),
        ("rgpszUsageIdentifier", ctypes.c_void_p),
    ]

class CRYPT_INTEGER_BLOB(ctypes.Structure):
    _fields_ = [
        ("cbData", wintypes.DWORD),
        ("pbData", ctypes.c_void_p),
    ]

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

class CRYPT_ALGORITHM_IDENTIFIER(ctypes.Structure):
    _fields_ = [
        ("pszObjId", ctypes.c_void_p),
        ("Parameters", CRYPT_INTEGER_BLOB),
    ]

class CTL_INFO(ctypes.Structure):
    _fields_ = [
        ("dwVersion", wintypes.DWORD),
        ("SubjectUsage", CTL_USAGE),
        ("ListIdentifier", CRYPT_INTEGER_BLOB),
        ("SequenceNumber", CRYPT_INTEGER_BLOB),
        ("ThisUpdate", FILETIME),
        ("NextUpdate", FILETIME),
        ("SubjectAlgorithm", CRYPT_ALGORITHM_IDENTIFIER),
        ("cCTLEntry", wintypes.DWORD),
        ("rgCTLEntry", ctypes.c_void_p),
        ("cExtension", wintypes.DWORD),
        ("rgExtension", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct CTL_USAGE {
    pub cUsageIdentifier: u32,
    pub rgpszUsageIdentifier: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct CRYPT_INTEGER_BLOB {
    pub cbData: u32,
    pub pbData: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct CRYPT_ALGORITHM_IDENTIFIER {
    pub pszObjId: *mut core::ffi::c_void,
    pub Parameters: CRYPT_INTEGER_BLOB,
}

#[repr(C)]
pub struct CTL_INFO {
    pub dwVersion: u32,
    pub SubjectUsage: CTL_USAGE,
    pub ListIdentifier: CRYPT_INTEGER_BLOB,
    pub SequenceNumber: CRYPT_INTEGER_BLOB,
    pub ThisUpdate: FILETIME,
    pub NextUpdate: FILETIME,
    pub SubjectAlgorithm: CRYPT_ALGORITHM_IDENTIFIER,
    pub cCTLEntry: u32,
    pub rgCTLEntry: *mut core::ffi::c_void,
    pub cExtension: u32,
    pub rgExtension: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type CTL_USAGE struct {
	cUsageIdentifier uint32
	rgpszUsageIdentifier uintptr
}

type CRYPT_INTEGER_BLOB struct {
	cbData uint32
	pbData uintptr
}

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type CRYPT_ALGORITHM_IDENTIFIER struct {
	pszObjId uintptr
	Parameters CRYPT_INTEGER_BLOB
}

type CTL_INFO struct {
	dwVersion uint32
	SubjectUsage CTL_USAGE
	ListIdentifier CRYPT_INTEGER_BLOB
	SequenceNumber CRYPT_INTEGER_BLOB
	ThisUpdate FILETIME
	NextUpdate FILETIME
	SubjectAlgorithm CRYPT_ALGORITHM_IDENTIFIER
	cCTLEntry uint32
	rgCTLEntry uintptr
	cExtension uint32
	rgExtension uintptr
}
type
  CTL_USAGE = record
    cUsageIdentifier: DWORD;
    rgpszUsageIdentifier: Pointer;
  end;

  CRYPT_INTEGER_BLOB = record
    cbData: DWORD;
    pbData: Pointer;
  end;

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

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

  CTL_INFO = record
    dwVersion: DWORD;
    SubjectUsage: CTL_USAGE;
    ListIdentifier: CRYPT_INTEGER_BLOB;
    SequenceNumber: CRYPT_INTEGER_BLOB;
    ThisUpdate: FILETIME;
    NextUpdate: FILETIME;
    SubjectAlgorithm: CRYPT_ALGORITHM_IDENTIFIER;
    cCTLEntry: DWORD;
    rgCTLEntry: Pointer;
    cExtension: DWORD;
    rgExtension: Pointer;
  end;
const CTL_USAGE = extern struct {
    cUsageIdentifier: u32,
    rgpszUsageIdentifier: ?*anyopaque,
};

const CRYPT_INTEGER_BLOB = extern struct {
    cbData: u32,
    pbData: ?*anyopaque,
};

const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const CRYPT_ALGORITHM_IDENTIFIER = extern struct {
    pszObjId: ?*anyopaque,
    Parameters: CRYPT_INTEGER_BLOB,
};

const CTL_INFO = extern struct {
    dwVersion: u32,
    SubjectUsage: CTL_USAGE,
    ListIdentifier: CRYPT_INTEGER_BLOB,
    SequenceNumber: CRYPT_INTEGER_BLOB,
    ThisUpdate: FILETIME,
    NextUpdate: FILETIME,
    SubjectAlgorithm: CRYPT_ALGORITHM_IDENTIFIER,
    cCTLEntry: u32,
    rgCTLEntry: ?*anyopaque,
    cExtension: u32,
    rgExtension: ?*anyopaque,
};
type
  CTL_USAGE {.bycopy.} = object
    cUsageIdentifier: uint32
    rgpszUsageIdentifier: pointer

  CRYPT_INTEGER_BLOB {.bycopy.} = object
    cbData: uint32
    pbData: pointer

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

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

  CTL_INFO {.bycopy.} = object
    dwVersion: uint32
    SubjectUsage: CTL_USAGE
    ListIdentifier: CRYPT_INTEGER_BLOB
    SequenceNumber: CRYPT_INTEGER_BLOB
    ThisUpdate: FILETIME
    NextUpdate: FILETIME
    SubjectAlgorithm: CRYPT_ALGORITHM_IDENTIFIER
    cCTLEntry: uint32
    rgCTLEntry: pointer
    cExtension: uint32
    rgExtension: pointer
struct CTL_USAGE
{
    uint cUsageIdentifier;
    void* rgpszUsageIdentifier;
}

struct CRYPT_INTEGER_BLOB
{
    uint cbData;
    void* pbData;
}

struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct CRYPT_ALGORITHM_IDENTIFIER
{
    void* pszObjId;
    CRYPT_INTEGER_BLOB Parameters;
}

struct CTL_INFO
{
    uint dwVersion;
    CTL_USAGE SubjectUsage;
    CRYPT_INTEGER_BLOB ListIdentifier;
    CRYPT_INTEGER_BLOB SequenceNumber;
    FILETIME ThisUpdate;
    FILETIME NextUpdate;
    CRYPT_ALGORITHM_IDENTIFIER SubjectAlgorithm;
    uint cCTLEntry;
    void* rgCTLEntry;
    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 レイアウト)
; CTL_INFO サイズ: 72 バイト(x86)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; SubjectUsage : CTL_USAGE (+4, 8byte)  varptr(st)+4 を基点に操作(8byte:入れ子/配列)
; ListIdentifier : CRYPT_INTEGER_BLOB (+12, 8byte)  varptr(st)+12 を基点に操作(8byte:入れ子/配列)
; SequenceNumber : CRYPT_INTEGER_BLOB (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; ThisUpdate : FILETIME (+28, 8byte)  varptr(st)+28 を基点に操作(8byte:入れ子/配列)
; NextUpdate : FILETIME (+36, 8byte)  varptr(st)+36 を基点に操作(8byte:入れ子/配列)
; SubjectAlgorithm : CRYPT_ALGORITHM_IDENTIFIER (+44, 12byte)  varptr(st)+44 を基点に操作(12byte:入れ子/配列)
; cCTLEntry : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; rgCTLEntry : CTL_ENTRY* (+60, 4byte)  varptr(st)+60 を基点に操作(4byte:入れ子/配列)
; cExtension : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; rgExtension : CERT_EXTENSION* (+68, 4byte)  varptr(st)+68 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CTL_INFO サイズ: 128 バイト(x64)
dim st, 32    ; 4byte整数×32(構造体サイズ 128 / 4 切り上げ)
; dwVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; SubjectUsage : CTL_USAGE (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; ListIdentifier : CRYPT_INTEGER_BLOB (+24, 16byte)  varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; SequenceNumber : CRYPT_INTEGER_BLOB (+40, 16byte)  varptr(st)+40 を基点に操作(16byte:入れ子/配列)
; ThisUpdate : FILETIME (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; NextUpdate : FILETIME (+64, 8byte)  varptr(st)+64 を基点に操作(8byte:入れ子/配列)
; SubjectAlgorithm : CRYPT_ALGORITHM_IDENTIFIER (+72, 24byte)  varptr(st)+72 を基点に操作(24byte:入れ子/配列)
; cCTLEntry : DWORD (+96, 4byte)  st.24 = 値  /  値 = st.24   (lpoke/lpeek も可)
; rgCTLEntry : CTL_ENTRY* (+104, 8byte)  varptr(st)+104 を基点に操作(8byte:入れ子/配列)
; cExtension : DWORD (+112, 4byte)  st.28 = 値  /  値 = st.28   (lpoke/lpeek も可)
; rgExtension : CERT_EXTENSION* (+120, 8byte)  varptr(st)+120 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global CTL_USAGE
    #field int cUsageIdentifier
    #field intptr rgpszUsageIdentifier
#endstruct

#defstruct global CRYPT_INTEGER_BLOB
    #field int cbData
    #field intptr pbData
#endstruct

#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global CRYPT_ALGORITHM_IDENTIFIER
    #field intptr pszObjId
    #field CRYPT_INTEGER_BLOB Parameters
#endstruct

#defstruct global CTL_INFO
    #field int dwVersion
    #field CTL_USAGE SubjectUsage
    #field CRYPT_INTEGER_BLOB ListIdentifier
    #field CRYPT_INTEGER_BLOB SequenceNumber
    #field FILETIME ThisUpdate
    #field FILETIME NextUpdate
    #field CRYPT_ALGORITHM_IDENTIFIER SubjectAlgorithm
    #field int cCTLEntry
    #field intptr rgCTLEntry
    #field int cExtension
    #field intptr rgExtension
#endstruct

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