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

CRYPT_VERIFY_MESSAGE_PARA

構造体
サイズx64: 32 バイト / x86: 20 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ (バイト単位)。
dwMsgAndCertEncodingTypeDWORD4+4+4

使用するエンコードの種類。次の例のように、証明書のエンコードの種類とメッセージのエンコードの種類をビット単位の OR 演算で組み合わせて指定することは、常に許容されます。

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

現在定義されているエンコードの種類は次のとおりです。

hCryptProvHCRYPTPROV_LEGACY8/4+8+8

このメンバーは使用されないため、NULL を設定してください。

Windows Server 2003 および Windows XP: 署名付きメッセージの検証に使用する暗号化サービス プロバイダーへのハンドル。このハンドルで識別される CSP は、ハッシュ処理と署名の検証に使用されます。特定の暗号化プロバイダーを使用する明確な理由がない限り、既定の RSA プロバイダーまたは DSS プロバイダーを使用するために 0 を設定してください。

このメンバーのデータ型は HCRYPTPROV です。

pfnGetSignerCertificatePFN_CRYPT_GET_SIGNER_CERTIFICATE8/4+16+12

署名者の証明書コンテキストを取得するために使用されるコールバック関数へのポインター。NULL の場合は、既定のコールバックが使用されます。既定のコールバックは、メッセージの証明書ストアから署名者の証明書コンテキストを取得しようとします。

既定のコールバックの代わりに、署名者の証明書を取得するアプリケーション定義のコールバック関数を使用できます。この関数には、署名者の証明書識別子 (発行者とシリアル番号) と、暗号化された署名付きメッセージの証明書ストアへのハンドルが渡されます。

コールバック関数のシグネチャと引数については、CryptGetSignerCertificateCallback を参照してください。

pvGetArgvoid*8/4+24+16コールバック関数に渡す引数。通常、このコールバックはメッセージの署名者の証明書を取得して検証します。

公式ドキュメント

CRYPT_VERIFY_MESSAGE_PARA 構造体は、署名付きメッセージの検証に必要な情報を格納します。

解説(Remarks)

この構造体は、次の関数に渡されます。

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

各言語での定義

#include <windows.h>

// CRYPT_VERIFY_MESSAGE_PARA  (x64 32 / x86 20 バイト)
typedef struct CRYPT_VERIFY_MESSAGE_PARA {
    DWORD cbSize;
    DWORD dwMsgAndCertEncodingType;
    HCRYPTPROV_LEGACY hCryptProv;
    PFN_CRYPT_GET_SIGNER_CERTIFICATE pfnGetSignerCertificate;
    void* pvGetArg;
} CRYPT_VERIFY_MESSAGE_PARA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_VERIFY_MESSAGE_PARA
{
    public uint cbSize;
    public uint dwMsgAndCertEncodingType;
    public UIntPtr hCryptProv;
    public IntPtr pfnGetSignerCertificate;
    public IntPtr pvGetArg;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPT_VERIFY_MESSAGE_PARA
    Public cbSize As UInteger
    Public dwMsgAndCertEncodingType As UInteger
    Public hCryptProv As UIntPtr
    Public pfnGetSignerCertificate As IntPtr
    Public pvGetArg As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class CRYPT_VERIFY_MESSAGE_PARA(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("dwMsgAndCertEncodingType", wintypes.DWORD),
        ("hCryptProv", ctypes.c_size_t),
        ("pfnGetSignerCertificate", ctypes.c_void_p),
        ("pvGetArg", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct CRYPT_VERIFY_MESSAGE_PARA {
    pub cbSize: u32,
    pub dwMsgAndCertEncodingType: u32,
    pub hCryptProv: usize,
    pub pfnGetSignerCertificate: *mut core::ffi::c_void,
    pub pvGetArg: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type CRYPT_VERIFY_MESSAGE_PARA struct {
	cbSize uint32
	dwMsgAndCertEncodingType uint32
	hCryptProv uintptr
	pfnGetSignerCertificate uintptr
	pvGetArg uintptr
}
type
  CRYPT_VERIFY_MESSAGE_PARA = record
    cbSize: DWORD;
    dwMsgAndCertEncodingType: DWORD;
    hCryptProv: NativeUInt;
    pfnGetSignerCertificate: Pointer;
    pvGetArg: Pointer;
  end;
const CRYPT_VERIFY_MESSAGE_PARA = extern struct {
    cbSize: u32,
    dwMsgAndCertEncodingType: u32,
    hCryptProv: usize,
    pfnGetSignerCertificate: ?*anyopaque,
    pvGetArg: ?*anyopaque,
};
type
  CRYPT_VERIFY_MESSAGE_PARA {.bycopy.} = object
    cbSize: uint32
    dwMsgAndCertEncodingType: uint32
    hCryptProv: uint
    pfnGetSignerCertificate: pointer
    pvGetArg: pointer
struct CRYPT_VERIFY_MESSAGE_PARA
{
    uint cbSize;
    uint dwMsgAndCertEncodingType;
    size_t hCryptProv;
    void* pfnGetSignerCertificate;
    void* pvGetArg;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPT_VERIFY_MESSAGE_PARA サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwMsgAndCertEncodingType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hCryptProv : HCRYPTPROV_LEGACY (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pfnGetSignerCertificate : PFN_CRYPT_GET_SIGNER_CERTIFICATE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; pvGetArg : void* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPT_VERIFY_MESSAGE_PARA サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwMsgAndCertEncodingType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hCryptProv : HCRYPTPROV_LEGACY (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pfnGetSignerCertificate : PFN_CRYPT_GET_SIGNER_CERTIFICATE (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pvGetArg : void* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPT_VERIFY_MESSAGE_PARA
    #field int cbSize
    #field int dwMsgAndCertEncodingType
    #field intptr hCryptProv
    #field intptr pfnGetSignerCertificate
    #field intptr pvGetArg
#endstruct

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