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

CRYPT_PROVIDER_SGNR

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 64 バイト / x86: 44 バイト

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

フィールド

フィールド型サイズx64x86説明
cbStructDWORD4+0+0この構造体のサイズ (バイト単位)。
sftVerifyAsOfFILETIME8+4+4現在の時刻、またはタイム スタンプ。
csCertChainDWORD4+12+12pasCertChain 配列の要素数。
pasCertChainCRYPT_PROVIDER_CERT*8/4+16+16CRYPT_PROVIDER_CERT 構造体の配列。
dwSignerTypeDWORD4+24+20

ポリシーが認識している場合の署名者の種類。署名者の種類が不明な場合、この値は 0 になります。それ以外の場合は次の値になります。

値 意味
SGNR_TYPE_TIMESTAMP
0x00000010
 タイム スタンプの署名者です。
psSignerCMSG_SIGNER_INFO*8/4+32+24CMSG_SIGNER_INFO 構造体へのポインター。
dwErrorDWORD4+40+28署名者の構築または検証中にエラーが発生した場合の、そのエラー値。
csCounterSignersDWORD4+44+32pasCounterSigners 配列の要素数。
pasCounterSignersCRYPT_PROVIDER_SGNR*8/4+48+36副署者を表す CRYPT_PROVIDER_SGNR 構造体の配列へのポインター。
pChainContextCERT_CHAIN_CONTEXT*8/4+56+40CERT_CHAIN_CONTEXT 構造体へのポインター。

公式ドキュメント

[CRYPT_PROVIDER_SGNR 構造体は、要件セクションに示されているオペレーティング システムで使用できます。以降のバージョンでは変更されるか、使用できなくなる可能性があります。]

CRYPT_PROVIDER_SGNR 構造体は、署名者または副署者に関する情報を提供します。

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

各言語での定義

#include <windows.h>

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

// CRYPT_PROVIDER_SGNR  (x64 64 / x86 44 バイト)
typedef struct CRYPT_PROVIDER_SGNR {
    DWORD cbStruct;
    FILETIME sftVerifyAsOf;
    DWORD csCertChain;
    CRYPT_PROVIDER_CERT* pasCertChain;
    DWORD dwSignerType;
    CMSG_SIGNER_INFO* psSigner;
    DWORD dwError;
    DWORD csCounterSigners;
    CRYPT_PROVIDER_SGNR* pasCounterSigners;
    CERT_CHAIN_CONTEXT* pChainContext;
} CRYPT_PROVIDER_SGNR;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_PROVIDER_SGNR
{
    public uint cbStruct;
    public FILETIME sftVerifyAsOf;
    public uint csCertChain;
    public IntPtr pasCertChain;
    public uint dwSignerType;
    public IntPtr psSigner;
    public uint dwError;
    public uint csCounterSigners;
    public IntPtr pasCounterSigners;
    public IntPtr pChainContext;
}
Imports System.Runtime.InteropServices

<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_PROVIDER_SGNR
    Public cbStruct As UInteger
    Public sftVerifyAsOf As FILETIME
    Public csCertChain As UInteger
    Public pasCertChain As IntPtr
    Public dwSignerType As UInteger
    Public psSigner As IntPtr
    Public dwError As UInteger
    Public csCounterSigners As UInteger
    Public pasCounterSigners As IntPtr
    Public pChainContext As IntPtr
End Structure
import ctypes
from ctypes import wintypes

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

class CRYPT_PROVIDER_SGNR(ctypes.Structure):
    _fields_ = [
        ("cbStruct", wintypes.DWORD),
        ("sftVerifyAsOf", FILETIME),
        ("csCertChain", wintypes.DWORD),
        ("pasCertChain", ctypes.c_void_p),
        ("dwSignerType", wintypes.DWORD),
        ("psSigner", ctypes.c_void_p),
        ("dwError", wintypes.DWORD),
        ("csCounterSigners", wintypes.DWORD),
        ("pasCounterSigners", ctypes.c_void_p),
        ("pChainContext", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct CRYPT_PROVIDER_SGNR {
    pub cbStruct: u32,
    pub sftVerifyAsOf: FILETIME,
    pub csCertChain: u32,
    pub pasCertChain: *mut core::ffi::c_void,
    pub dwSignerType: u32,
    pub psSigner: *mut core::ffi::c_void,
    pub dwError: u32,
    pub csCounterSigners: u32,
    pub pasCounterSigners: *mut core::ffi::c_void,
    pub pChainContext: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type CRYPT_PROVIDER_SGNR struct {
	cbStruct uint32
	sftVerifyAsOf FILETIME
	csCertChain uint32
	pasCertChain uintptr
	dwSignerType uint32
	psSigner uintptr
	dwError uint32
	csCounterSigners uint32
	pasCounterSigners uintptr
	pChainContext uintptr
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  CRYPT_PROVIDER_SGNR = record
    cbStruct: DWORD;
    sftVerifyAsOf: FILETIME;
    csCertChain: DWORD;
    pasCertChain: Pointer;
    dwSignerType: DWORD;
    psSigner: Pointer;
    dwError: DWORD;
    csCounterSigners: DWORD;
    pasCounterSigners: Pointer;
    pChainContext: Pointer;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const CRYPT_PROVIDER_SGNR = extern struct {
    cbStruct: u32,
    sftVerifyAsOf: FILETIME,
    csCertChain: u32,
    pasCertChain: ?*anyopaque,
    dwSignerType: u32,
    psSigner: ?*anyopaque,
    dwError: u32,
    csCounterSigners: u32,
    pasCounterSigners: ?*anyopaque,
    pChainContext: ?*anyopaque,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  CRYPT_PROVIDER_SGNR {.bycopy.} = object
    cbStruct: uint32
    sftVerifyAsOf: FILETIME
    csCertChain: uint32
    pasCertChain: pointer
    dwSignerType: uint32
    psSigner: pointer
    dwError: uint32
    csCounterSigners: uint32
    pasCounterSigners: pointer
    pChainContext: pointer
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct CRYPT_PROVIDER_SGNR
{
    uint cbStruct;
    FILETIME sftVerifyAsOf;
    uint csCertChain;
    void* pasCertChain;
    uint dwSignerType;
    void* psSigner;
    uint dwError;
    uint csCounterSigners;
    void* pasCounterSigners;
    void* pChainContext;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPT_PROVIDER_SGNR サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; sftVerifyAsOf : FILETIME (+4, 8byte)  varptr(st)+4 を基点に操作(8byte:入れ子/配列)
; csCertChain : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pasCertChain : CRYPT_PROVIDER_CERT* (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; dwSignerType : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; psSigner : CMSG_SIGNER_INFO* (+24, 4byte)  varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; dwError : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; csCounterSigners : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; pasCounterSigners : CRYPT_PROVIDER_SGNR* (+36, 4byte)  varptr(st)+36 を基点に操作(4byte:入れ子/配列)
; pChainContext : CERT_CHAIN_CONTEXT* (+40, 4byte)  varptr(st)+40 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPT_PROVIDER_SGNR サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; sftVerifyAsOf : FILETIME (+4, 8byte)  varptr(st)+4 を基点に操作(8byte:入れ子/配列)
; csCertChain : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pasCertChain : CRYPT_PROVIDER_CERT* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; dwSignerType : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; psSigner : CMSG_SIGNER_INFO* (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; dwError : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; csCounterSigners : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; pasCounterSigners : CRYPT_PROVIDER_SGNR* (+48, 8byte)  varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; pChainContext : CERT_CHAIN_CONTEXT* (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global CRYPT_PROVIDER_SGNR
    #field int cbStruct
    #field FILETIME sftVerifyAsOf
    #field int csCertChain
    #field intptr pasCertChain
    #field int dwSignerType
    #field intptr psSigner
    #field int dwError
    #field int csCounterSigners
    #field intptr pasCounterSigners
    #field intptr pChainContext
#endstruct

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