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

CryptMsgVerifyCountersignatureEncodedEx

関数
エンコードされた副署名を検証する拡張版関数。
DLLCRYPT32.dll呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

// CRYPT32.dll
#include <windows.h>

BOOL CryptMsgVerifyCountersignatureEncodedEx(
    HCRYPTPROV_LEGACY hCryptProv,   // optional
    DWORD dwEncodingType,
    BYTE* pbSignerInfo,
    DWORD cbSignerInfo,
    BYTE* pbSignerInfoCountersignature,
    DWORD cbSignerInfoCountersignature,
    DWORD dwSignerType,
    void* pvSigner,
    DWORD dwFlags,
    void* pvExtra   // optional
);

パラメーター

名前方向説明
hCryptProvHCRYPTPROV_LEGACYinoptional

このパラメーターは使用されず、NULL に設定する必要があります。

Windows Server 2003 および Windows XP: pbSignerInfo の encryptedDigest フィールドをハッシュするために使用する暗号化プロバイダーのハンドル、または NULL です。このパラメーターのデータ型は HCRYPTPROV です。

特定の暗号化プロバイダーを hCryptProv に渡す明確な理由がない限り、NULL を渡して既定の RSA または DSS プロバイダーを使用させてください。

dwEncodingTypeDWORDin

使用するエンコード方式です。現在は X509_ASN_ENCODINGPKCS_7_ASN_ENCODING のみが使用されていますが、将来的にエンコード方式が追加される可能性があります。現在のいずれのエンコード方式でも、次を使用します。

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

pbSignerInfoBYTE*inカウンター署名されるメッセージの内容の署名者を含む、エンコードされた BLOB へのポインターです。
cbSignerInfoDWORDin内容の署名者用のエンコードされた BLOB のバイト数です。
pbSignerInfoCountersignatureBYTE*inカウンター署名者情報を含む、エンコードされた BLOB へのポインターです。
cbSignerInfoCountersignatureDWORDinメッセージのカウンター署名者用のエンコードされた BLOB のバイト数です。
dwSignerTypeDWORDin

署名者情報を含む構造体です。次の表に、定義済みの値と、それが示す構造体を示します。

意味
CMSG_VERIFY_SIGNER_PUBKEY
pvSignerCERT_PUBLIC_KEY_INFO 構造体へのポインターです。
CMSG_VERIFY_SIGNER_CERT
pvSignerCERT_CONTEXT 構造体へのポインターです。
CMSG_VERIFY_SIGNER_CHAIN
pvSignerCERT_CHAIN_CONTEXT 構造体へのポインターです。
pvSignervoid*indwSignerType の値に応じて、CERT_PUBLIC_KEY_INFO 構造体、証明書コンテキスト、またはチェーンコンテキストへのポインターです。
dwFlagsDWORDin

関数の動作を変更するフラグです。ゼロ、または次の値を指定できます。

意味
CMSG_VERIFY_COUNTER_SIGN_ENABLE_STRONG_FLAG
0x00000001
署名の検証が成功した後に、強力な署名チェックを実行します。pvExtra パラメーターには、署名の強度をチェックするために必要なパラメーターを含む CERT_STRONG_SIGN_PARA 構造体を指すように設定します。

Windows 8 および Windows Server 2012: このフラグのサポートが開始されました。

pvExtravoid*inoutoptionaldwFlags パラメーターに CMSG_VERIFY_COUNTER_SIGN_ENABLE_STRONG_FLAG を設定した場合、このパラメーター (pvExtra) には、署名の強度をチェックするために使用するパラメーターを含む CERT_STRONG_SIGN_PARA 構造体を指すように設定します。

戻り値の型: BOOL

公式ドキュメント

pbSignerInfoCounterSignature パラメーターに、pbSignerInfo パラメーター構造体の encryptedDigest フィールドの暗号化されたハッシュが含まれていることを検証します。

戻り値

関数が成功すると、戻り値は非ゼロ (TRUE) になります。

関数が失敗すると、戻り値はゼロ (FALSE) になります。 拡張エラー情報を取得するには、 GetLastError を呼び出します。

次のエラーコードは、 GetLastError 関数によって最も一般的に返されるものです。

戻り値 説明
CRYPT_E_AUTH_ATTR_MISSING
メッセージに、期待される認証済み属性が含まれていません。
CRYPT_E_HASH_VALUE
ハッシュ値が正しくありません。
CRYPT_E_UNEXPECTED_ENCODING
メッセージが期待どおりにエンコードされていません。
CRYPT_E_UNKNOWN_ALGO
暗号化アルゴリズムが不明です。
E_INVALIDARG
1 つ以上の引数が無効です。
E_OUTOFMEMORY
メモリが不足しました。

次の関数から伝播したエラーが返される場合があります。

関数が失敗した場合、GetLastErrorAbstract Syntax Notation One (ASN.1) のエンコード/デコードエラーを返すことがあります。これらのエラーについては、 ASN.1 Encoding/Decoding Return Values を参照してください。

解説(Remarks)

カウンター署名者の検証は、PKCS #7 の SIGNERINFO 構造体を使用して行われます。署名には、pbSignerInfo の encryptedDigest フィールドの暗号化されたハッシュが含まれている必要があります。

カウンター署名者の発行者とシリアル番号は、pbSignerInfoCountersignature のカウンター署名者情報と一致する必要があります。pciCountersigner から参照されるフィールドは SerialNumber、Issuer、SubjectPublicKeyInfo のみです。SubjectPublicKeyInfo は公開キーへのアクセスに使用され、その公開キーを使用して pciCountersignerハッシュを暗号化し、pbSignerInfo のハッシュと比較します。

この関数を使用する例については、 Example C Program: Encoding and Decoding a CounterSigned Message を参照してください。

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

各言語での呼び出し定義

// CRYPT32.dll
#include <windows.h>

BOOL CryptMsgVerifyCountersignatureEncodedEx(
    HCRYPTPROV_LEGACY hCryptProv,   // optional
    DWORD dwEncodingType,
    BYTE* pbSignerInfo,
    DWORD cbSignerInfo,
    BYTE* pbSignerInfoCountersignature,
    DWORD cbSignerInfoCountersignature,
    DWORD dwSignerType,
    void* pvSigner,
    DWORD dwFlags,
    void* pvExtra   // optional
);
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPT32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool CryptMsgVerifyCountersignatureEncodedEx(
    UIntPtr hCryptProv,   // HCRYPTPROV_LEGACY optional
    uint dwEncodingType,   // DWORD
    IntPtr pbSignerInfo,   // BYTE*
    uint cbSignerInfo,   // DWORD
    IntPtr pbSignerInfoCountersignature,   // BYTE*
    uint cbSignerInfoCountersignature,   // DWORD
    uint dwSignerType,   // DWORD
    IntPtr pvSigner,   // void*
    uint dwFlags,   // DWORD
    IntPtr pvExtra   // void* optional, in/out
);
<DllImport("CRYPT32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CryptMsgVerifyCountersignatureEncodedEx(
    hCryptProv As UIntPtr,   ' HCRYPTPROV_LEGACY optional
    dwEncodingType As UInteger,   ' DWORD
    pbSignerInfo As IntPtr,   ' BYTE*
    cbSignerInfo As UInteger,   ' DWORD
    pbSignerInfoCountersignature As IntPtr,   ' BYTE*
    cbSignerInfoCountersignature As UInteger,   ' DWORD
    dwSignerType As UInteger,   ' DWORD
    pvSigner As IntPtr,   ' void*
    dwFlags As UInteger,   ' DWORD
    pvExtra As IntPtr   ' void* optional, in/out
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function
' hCryptProv : HCRYPTPROV_LEGACY optional
' dwEncodingType : DWORD
' pbSignerInfo : BYTE*
' cbSignerInfo : DWORD
' pbSignerInfoCountersignature : BYTE*
' cbSignerInfoCountersignature : DWORD
' dwSignerType : DWORD
' pvSigner : void*
' dwFlags : DWORD
' pvExtra : void* optional, in/out
Declare PtrSafe Function CryptMsgVerifyCountersignatureEncodedEx Lib "crypt32" ( _
    ByVal hCryptProv As LongPtr, _
    ByVal dwEncodingType As Long, _
    ByVal pbSignerInfo As LongPtr, _
    ByVal cbSignerInfo As Long, _
    ByVal pbSignerInfoCountersignature As LongPtr, _
    ByVal cbSignerInfoCountersignature As Long, _
    ByVal dwSignerType As Long, _
    ByVal pvSigner As LongPtr, _
    ByVal dwFlags As Long, _
    ByVal pvExtra As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

CryptMsgVerifyCountersignatureEncodedEx = ctypes.windll.crypt32.CryptMsgVerifyCountersignatureEncodedEx
CryptMsgVerifyCountersignatureEncodedEx.restype = wintypes.BOOL
CryptMsgVerifyCountersignatureEncodedEx.argtypes = [
    ctypes.c_size_t,  # hCryptProv : HCRYPTPROV_LEGACY optional
    wintypes.DWORD,  # dwEncodingType : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # pbSignerInfo : BYTE*
    wintypes.DWORD,  # cbSignerInfo : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # pbSignerInfoCountersignature : BYTE*
    wintypes.DWORD,  # cbSignerInfoCountersignature : DWORD
    wintypes.DWORD,  # dwSignerType : DWORD
    ctypes.POINTER(None),  # pvSigner : void*
    wintypes.DWORD,  # dwFlags : DWORD
    ctypes.POINTER(None),  # pvExtra : void* optional, in/out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CRYPT32.dll')
CryptMsgVerifyCountersignatureEncodedEx = Fiddle::Function.new(
  lib['CryptMsgVerifyCountersignatureEncodedEx'],
  [
    Fiddle::TYPE_UINTPTR_T,  # hCryptProv : HCRYPTPROV_LEGACY optional
    -Fiddle::TYPE_INT,  # dwEncodingType : DWORD
    Fiddle::TYPE_VOIDP,  # pbSignerInfo : BYTE*
    -Fiddle::TYPE_INT,  # cbSignerInfo : DWORD
    Fiddle::TYPE_VOIDP,  # pbSignerInfoCountersignature : BYTE*
    -Fiddle::TYPE_INT,  # cbSignerInfoCountersignature : DWORD
    -Fiddle::TYPE_INT,  # dwSignerType : DWORD
    Fiddle::TYPE_VOIDP,  # pvSigner : void*
    -Fiddle::TYPE_INT,  # dwFlags : DWORD
    Fiddle::TYPE_VOIDP,  # pvExtra : void* optional, in/out
  ],
  Fiddle::TYPE_INT)
#[link(name = "crypt32")]
extern "system" {
    fn CryptMsgVerifyCountersignatureEncodedEx(
        hCryptProv: usize,  // HCRYPTPROV_LEGACY optional
        dwEncodingType: u32,  // DWORD
        pbSignerInfo: *mut u8,  // BYTE*
        cbSignerInfo: u32,  // DWORD
        pbSignerInfoCountersignature: *mut u8,  // BYTE*
        cbSignerInfoCountersignature: u32,  // DWORD
        dwSignerType: u32,  // DWORD
        pvSigner: *mut (),  // void*
        dwFlags: u32,  // DWORD
        pvExtra: *mut ()  // void* optional, in/out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPT32.dll", SetLastError = true)]
public static extern bool CryptMsgVerifyCountersignatureEncodedEx(UIntPtr hCryptProv, uint dwEncodingType, IntPtr pbSignerInfo, uint cbSignerInfo, IntPtr pbSignerInfoCountersignature, uint cbSignerInfoCountersignature, uint dwSignerType, IntPtr pvSigner, uint dwFlags, IntPtr pvExtra);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CryptMsgVerifyCountersignatureEncodedEx' -Namespace Win32 -PassThru
# $api::CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra)
#uselib "CRYPT32.dll"
#func global CryptMsgVerifyCountersignatureEncodedEx "CryptMsgVerifyCountersignatureEncodedEx" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; CryptMsgVerifyCountersignatureEncodedEx hCryptProv, dwEncodingType, varptr(pbSignerInfo), cbSignerInfo, varptr(pbSignerInfoCountersignature), cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra   ; 戻り値は stat
; hCryptProv : HCRYPTPROV_LEGACY optional -> "sptr"
; dwEncodingType : DWORD -> "sptr"
; pbSignerInfo : BYTE* -> "sptr"
; cbSignerInfo : DWORD -> "sptr"
; pbSignerInfoCountersignature : BYTE* -> "sptr"
; cbSignerInfoCountersignature : DWORD -> "sptr"
; dwSignerType : DWORD -> "sptr"
; pvSigner : void* -> "sptr"
; dwFlags : DWORD -> "sptr"
; pvExtra : void* optional, in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "CRYPT32.dll"
#cfunc global CryptMsgVerifyCountersignatureEncodedEx "CryptMsgVerifyCountersignatureEncodedEx" sptr, int, var, int, var, int, int, sptr, int, sptr
; res = CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra)
; hCryptProv : HCRYPTPROV_LEGACY optional -> "sptr"
; dwEncodingType : DWORD -> "int"
; pbSignerInfo : BYTE* -> "var"
; cbSignerInfo : DWORD -> "int"
; pbSignerInfoCountersignature : BYTE* -> "var"
; cbSignerInfoCountersignature : DWORD -> "int"
; dwSignerType : DWORD -> "int"
; pvSigner : void* -> "sptr"
; dwFlags : DWORD -> "int"
; pvExtra : void* optional, in/out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; BOOL CryptMsgVerifyCountersignatureEncodedEx(HCRYPTPROV_LEGACY hCryptProv, DWORD dwEncodingType, BYTE* pbSignerInfo, DWORD cbSignerInfo, BYTE* pbSignerInfoCountersignature, DWORD cbSignerInfoCountersignature, DWORD dwSignerType, void* pvSigner, DWORD dwFlags, void* pvExtra)
#uselib "CRYPT32.dll"
#cfunc global CryptMsgVerifyCountersignatureEncodedEx "CryptMsgVerifyCountersignatureEncodedEx" intptr, int, var, int, var, int, int, intptr, int, intptr
; res = CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra)
; hCryptProv : HCRYPTPROV_LEGACY optional -> "intptr"
; dwEncodingType : DWORD -> "int"
; pbSignerInfo : BYTE* -> "var"
; cbSignerInfo : DWORD -> "int"
; pbSignerInfoCountersignature : BYTE* -> "var"
; cbSignerInfoCountersignature : DWORD -> "int"
; dwSignerType : DWORD -> "int"
; pvSigner : void* -> "intptr"
; dwFlags : DWORD -> "int"
; pvExtra : void* optional, in/out -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	crypt32 = windows.NewLazySystemDLL("CRYPT32.dll")
	procCryptMsgVerifyCountersignatureEncodedEx = crypt32.NewProc("CryptMsgVerifyCountersignatureEncodedEx")
)

// hCryptProv (HCRYPTPROV_LEGACY optional), dwEncodingType (DWORD), pbSignerInfo (BYTE*), cbSignerInfo (DWORD), pbSignerInfoCountersignature (BYTE*), cbSignerInfoCountersignature (DWORD), dwSignerType (DWORD), pvSigner (void*), dwFlags (DWORD), pvExtra (void* optional, in/out)
r1, _, err := procCryptMsgVerifyCountersignatureEncodedEx.Call(
	uintptr(hCryptProv),
	uintptr(dwEncodingType),
	uintptr(pbSignerInfo),
	uintptr(cbSignerInfo),
	uintptr(pbSignerInfoCountersignature),
	uintptr(cbSignerInfoCountersignature),
	uintptr(dwSignerType),
	uintptr(pvSigner),
	uintptr(dwFlags),
	uintptr(pvExtra),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL
function CryptMsgVerifyCountersignatureEncodedEx(
  hCryptProv: NativeUInt;   // HCRYPTPROV_LEGACY optional
  dwEncodingType: DWORD;   // DWORD
  pbSignerInfo: Pointer;   // BYTE*
  cbSignerInfo: DWORD;   // DWORD
  pbSignerInfoCountersignature: Pointer;   // BYTE*
  cbSignerInfoCountersignature: DWORD;   // DWORD
  dwSignerType: DWORD;   // DWORD
  pvSigner: Pointer;   // void*
  dwFlags: DWORD;   // DWORD
  pvExtra: Pointer   // void* optional, in/out
): BOOL; stdcall;
  external 'CRYPT32.dll' name 'CryptMsgVerifyCountersignatureEncodedEx';
result := DllCall("CRYPT32\CryptMsgVerifyCountersignatureEncodedEx"
    , "UPtr", hCryptProv   ; HCRYPTPROV_LEGACY optional
    , "UInt", dwEncodingType   ; DWORD
    , "Ptr", pbSignerInfo   ; BYTE*
    , "UInt", cbSignerInfo   ; DWORD
    , "Ptr", pbSignerInfoCountersignature   ; BYTE*
    , "UInt", cbSignerInfoCountersignature   ; DWORD
    , "UInt", dwSignerType   ; DWORD
    , "Ptr", pvSigner   ; void*
    , "UInt", dwFlags   ; DWORD
    , "Ptr", pvExtra   ; void* optional, in/out
    , "Int")   ; return: BOOL
●CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra) = DLL("CRYPT32.dll", "bool CryptMsgVerifyCountersignatureEncodedEx(int, dword, void*, dword, void*, dword, dword, void*, dword, void*)")
# 呼び出し: CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra)
# hCryptProv : HCRYPTPROV_LEGACY optional -> "int"
# dwEncodingType : DWORD -> "dword"
# pbSignerInfo : BYTE* -> "void*"
# cbSignerInfo : DWORD -> "dword"
# pbSignerInfoCountersignature : BYTE* -> "void*"
# cbSignerInfoCountersignature : DWORD -> "dword"
# dwSignerType : DWORD -> "dword"
# pvSigner : void* -> "void*"
# dwFlags : DWORD -> "dword"
# pvExtra : void* optional, in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "crypt32" fn CryptMsgVerifyCountersignatureEncodedEx(
    hCryptProv: usize, // HCRYPTPROV_LEGACY optional
    dwEncodingType: u32, // DWORD
    pbSignerInfo: [*c]u8, // BYTE*
    cbSignerInfo: u32, // DWORD
    pbSignerInfoCountersignature: [*c]u8, // BYTE*
    cbSignerInfoCountersignature: u32, // DWORD
    dwSignerType: u32, // DWORD
    pvSigner: ?*anyopaque, // void*
    dwFlags: u32, // DWORD
    pvExtra: ?*anyopaque // void* optional, in/out
) callconv(std.os.windows.WINAPI) i32;
proc CryptMsgVerifyCountersignatureEncodedEx(
    hCryptProv: uint,  # HCRYPTPROV_LEGACY optional
    dwEncodingType: uint32,  # DWORD
    pbSignerInfo: ptr uint8,  # BYTE*
    cbSignerInfo: uint32,  # DWORD
    pbSignerInfoCountersignature: ptr uint8,  # BYTE*
    cbSignerInfoCountersignature: uint32,  # DWORD
    dwSignerType: uint32,  # DWORD
    pvSigner: pointer,  # void*
    dwFlags: uint32,  # DWORD
    pvExtra: pointer  # void* optional, in/out
): int32 {.importc: "CryptMsgVerifyCountersignatureEncodedEx", stdcall, dynlib: "CRYPT32.dll".}
pragma(lib, "crypt32");
extern(Windows)
int CryptMsgVerifyCountersignatureEncodedEx(
    size_t hCryptProv,   // HCRYPTPROV_LEGACY optional
    uint dwEncodingType,   // DWORD
    ubyte* pbSignerInfo,   // BYTE*
    uint cbSignerInfo,   // DWORD
    ubyte* pbSignerInfoCountersignature,   // BYTE*
    uint cbSignerInfoCountersignature,   // DWORD
    uint dwSignerType,   // DWORD
    void* pvSigner,   // void*
    uint dwFlags,   // DWORD
    void* pvExtra   // void* optional, in/out
);
ccall((:CryptMsgVerifyCountersignatureEncodedEx, "CRYPT32.dll"), stdcall, Int32,
      (Csize_t, UInt32, Ptr{UInt8}, UInt32, Ptr{UInt8}, UInt32, UInt32, Ptr{Cvoid}, UInt32, Ptr{Cvoid}),
      hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra)
# hCryptProv : HCRYPTPROV_LEGACY optional -> Csize_t
# dwEncodingType : DWORD -> UInt32
# pbSignerInfo : BYTE* -> Ptr{UInt8}
# cbSignerInfo : DWORD -> UInt32
# pbSignerInfoCountersignature : BYTE* -> Ptr{UInt8}
# cbSignerInfoCountersignature : DWORD -> UInt32
# dwSignerType : DWORD -> UInt32
# pvSigner : void* -> Ptr{Cvoid}
# dwFlags : DWORD -> UInt32
# pvExtra : void* optional, in/out -> Ptr{Cvoid}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
int32_t CryptMsgVerifyCountersignatureEncodedEx(
    uintptr_t hCryptProv,
    uint32_t dwEncodingType,
    uint8_t* pbSignerInfo,
    uint32_t cbSignerInfo,
    uint8_t* pbSignerInfoCountersignature,
    uint32_t cbSignerInfoCountersignature,
    uint32_t dwSignerType,
    void* pvSigner,
    uint32_t dwFlags,
    void* pvExtra);
]]
local crypt32 = ffi.load("crypt32")
-- crypt32.CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra)
-- hCryptProv : HCRYPTPROV_LEGACY optional
-- dwEncodingType : DWORD
-- pbSignerInfo : BYTE*
-- cbSignerInfo : DWORD
-- pbSignerInfoCountersignature : BYTE*
-- cbSignerInfoCountersignature : DWORD
-- dwSignerType : DWORD
-- pvSigner : void*
-- dwFlags : DWORD
-- pvExtra : void* optional, in/out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('CRYPT32.dll');
const CryptMsgVerifyCountersignatureEncodedEx = lib.func('__stdcall', 'CryptMsgVerifyCountersignatureEncodedEx', 'int32_t', ['uintptr_t', 'uint32_t', 'uint8_t *', 'uint32_t', 'uint8_t *', 'uint32_t', 'uint32_t', 'void *', 'uint32_t', 'void *']);
// CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra)
// hCryptProv : HCRYPTPROV_LEGACY optional -> 'uintptr_t'
// dwEncodingType : DWORD -> 'uint32_t'
// pbSignerInfo : BYTE* -> 'uint8_t *'
// cbSignerInfo : DWORD -> 'uint32_t'
// pbSignerInfoCountersignature : BYTE* -> 'uint8_t *'
// cbSignerInfoCountersignature : DWORD -> 'uint32_t'
// dwSignerType : DWORD -> 'uint32_t'
// pvSigner : void* -> 'void *'
// dwFlags : DWORD -> 'uint32_t'
// pvExtra : void* optional, in/out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("CRYPT32.dll", {
  CryptMsgVerifyCountersignatureEncodedEx: { parameters: ["usize", "u32", "pointer", "u32", "pointer", "u32", "u32", "pointer", "u32", "pointer"], result: "i32" },
});
// lib.symbols.CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra)
// hCryptProv : HCRYPTPROV_LEGACY optional -> "usize"
// dwEncodingType : DWORD -> "u32"
// pbSignerInfo : BYTE* -> "pointer"
// cbSignerInfo : DWORD -> "u32"
// pbSignerInfoCountersignature : BYTE* -> "pointer"
// cbSignerInfoCountersignature : DWORD -> "u32"
// dwSignerType : DWORD -> "u32"
// pvSigner : void* -> "pointer"
// dwFlags : DWORD -> "u32"
// pvExtra : void* optional, in/out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
int32_t CryptMsgVerifyCountersignatureEncodedEx(
    size_t hCryptProv,
    uint32_t dwEncodingType,
    uint8_t* pbSignerInfo,
    uint32_t cbSignerInfo,
    uint8_t* pbSignerInfoCountersignature,
    uint32_t cbSignerInfoCountersignature,
    uint32_t dwSignerType,
    void* pvSigner,
    uint32_t dwFlags,
    void* pvExtra);
C, "CRYPT32.dll");
// $ffi->CryptMsgVerifyCountersignatureEncodedEx(hCryptProv, dwEncodingType, pbSignerInfo, cbSignerInfo, pbSignerInfoCountersignature, cbSignerInfoCountersignature, dwSignerType, pvSigner, dwFlags, pvExtra);
// hCryptProv : HCRYPTPROV_LEGACY optional
// dwEncodingType : DWORD
// pbSignerInfo : BYTE*
// cbSignerInfo : DWORD
// pbSignerInfoCountersignature : BYTE*
// cbSignerInfoCountersignature : DWORD
// dwSignerType : DWORD
// pvSigner : void*
// dwFlags : DWORD
// pvExtra : void* optional, in/out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。
import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Crypt32 extends StdCallLibrary {
    Crypt32 INSTANCE = Native.load("crypt32", Crypt32.class);
    boolean CryptMsgVerifyCountersignatureEncodedEx(
        long hCryptProv,   // HCRYPTPROV_LEGACY optional
        int dwEncodingType,   // DWORD
        byte[] pbSignerInfo,   // BYTE*
        int cbSignerInfo,   // DWORD
        byte[] pbSignerInfoCountersignature,   // BYTE*
        int cbSignerInfoCountersignature,   // DWORD
        int dwSignerType,   // DWORD
        Pointer pvSigner,   // void*
        int dwFlags,   // DWORD
        Pointer pvExtra   // void* optional, in/out
    );
}
@[Link("crypt32")]
lib LibCRYPT32
  fun CryptMsgVerifyCountersignatureEncodedEx = CryptMsgVerifyCountersignatureEncodedEx(
    hCryptProv : LibC::SizeT,   # HCRYPTPROV_LEGACY optional
    dwEncodingType : UInt32,   # DWORD
    pbSignerInfo : UInt8*,   # BYTE*
    cbSignerInfo : UInt32,   # DWORD
    pbSignerInfoCountersignature : UInt8*,   # BYTE*
    cbSignerInfoCountersignature : UInt32,   # DWORD
    dwSignerType : UInt32,   # DWORD
    pvSigner : Void*,   # void*
    dwFlags : UInt32,   # DWORD
    pvExtra : Void*   # void* optional, in/out
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef CryptMsgVerifyCountersignatureEncodedExNative = Int32 Function(UintPtr, Uint32, Pointer<Uint8>, Uint32, Pointer<Uint8>, Uint32, Uint32, Pointer<Void>, Uint32, Pointer<Void>);
typedef CryptMsgVerifyCountersignatureEncodedExDart = int Function(int, int, Pointer<Uint8>, int, Pointer<Uint8>, int, int, Pointer<Void>, int, Pointer<Void>);
final CryptMsgVerifyCountersignatureEncodedEx = DynamicLibrary.open('CRYPT32.dll')
    .lookupFunction<CryptMsgVerifyCountersignatureEncodedExNative, CryptMsgVerifyCountersignatureEncodedExDart>('CryptMsgVerifyCountersignatureEncodedEx');
// hCryptProv : HCRYPTPROV_LEGACY optional -> UintPtr
// dwEncodingType : DWORD -> Uint32
// pbSignerInfo : BYTE* -> Pointer<Uint8>
// cbSignerInfo : DWORD -> Uint32
// pbSignerInfoCountersignature : BYTE* -> Pointer<Uint8>
// cbSignerInfoCountersignature : DWORD -> Uint32
// dwSignerType : DWORD -> Uint32
// pvSigner : void* -> Pointer<Void>
// dwFlags : DWORD -> Uint32
// pvExtra : void* optional, in/out -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function CryptMsgVerifyCountersignatureEncodedEx(
  hCryptProv: NativeUInt;   // HCRYPTPROV_LEGACY optional
  dwEncodingType: DWORD;   // DWORD
  pbSignerInfo: Pointer;   // BYTE*
  cbSignerInfo: DWORD;   // DWORD
  pbSignerInfoCountersignature: Pointer;   // BYTE*
  cbSignerInfoCountersignature: DWORD;   // DWORD
  dwSignerType: DWORD;   // DWORD
  pvSigner: Pointer;   // void*
  dwFlags: DWORD;   // DWORD
  pvExtra: Pointer   // void* optional, in/out
): BOOL; stdcall;
  external 'CRYPT32.dll' name 'CryptMsgVerifyCountersignatureEncodedEx';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "CryptMsgVerifyCountersignatureEncodedEx"
  c_CryptMsgVerifyCountersignatureEncodedEx :: CUIntPtr -> Word32 -> Ptr Word8 -> Word32 -> Ptr Word8 -> Word32 -> Word32 -> Ptr () -> Word32 -> Ptr () -> IO CInt
-- hCryptProv : HCRYPTPROV_LEGACY optional -> CUIntPtr
-- dwEncodingType : DWORD -> Word32
-- pbSignerInfo : BYTE* -> Ptr Word8
-- cbSignerInfo : DWORD -> Word32
-- pbSignerInfoCountersignature : BYTE* -> Ptr Word8
-- cbSignerInfoCountersignature : DWORD -> Word32
-- dwSignerType : DWORD -> Word32
-- pvSigner : void* -> Ptr ()
-- dwFlags : DWORD -> Word32
-- pvExtra : void* optional, in/out -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let cryptmsgverifycountersignatureencodedex =
  foreign "CryptMsgVerifyCountersignatureEncodedEx"
    (size_t @-> uint32_t @-> (ptr uint8_t) @-> uint32_t @-> (ptr uint8_t) @-> uint32_t @-> uint32_t @-> (ptr void) @-> uint32_t @-> (ptr void) @-> returning int32_t)
(* hCryptProv : HCRYPTPROV_LEGACY optional -> size_t *)
(* dwEncodingType : DWORD -> uint32_t *)
(* pbSignerInfo : BYTE* -> (ptr uint8_t) *)
(* cbSignerInfo : DWORD -> uint32_t *)
(* pbSignerInfoCountersignature : BYTE* -> (ptr uint8_t) *)
(* cbSignerInfoCountersignature : DWORD -> uint32_t *)
(* dwSignerType : DWORD -> uint32_t *)
(* pvSigner : void* -> (ptr void) *)
(* dwFlags : DWORD -> uint32_t *)
(* pvExtra : void* optional, in/out -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library crypt32 (t "CRYPT32.dll"))
(cffi:use-foreign-library crypt32)

(cffi:defcfun ("CryptMsgVerifyCountersignatureEncodedEx" crypt-msg-verify-countersignature-encoded-ex :convention :stdcall) :int32
  (h-crypt-prov :uint64)   ; HCRYPTPROV_LEGACY optional
  (dw-encoding-type :uint32)   ; DWORD
  (pb-signer-info :pointer)   ; BYTE*
  (cb-signer-info :uint32)   ; DWORD
  (pb-signer-info-countersignature :pointer)   ; BYTE*
  (cb-signer-info-countersignature :uint32)   ; DWORD
  (dw-signer-type :uint32)   ; DWORD
  (pv-signer :pointer)   ; void*
  (dw-flags :uint32)   ; DWORD
  (pv-extra :pointer))   ; void* optional, in/out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $CryptMsgVerifyCountersignatureEncodedEx = Win32::API::More->new('CRYPT32',
    'BOOL CryptMsgVerifyCountersignatureEncodedEx(WPARAM hCryptProv, DWORD dwEncodingType, LPVOID pbSignerInfo, DWORD cbSignerInfo, LPVOID pbSignerInfoCountersignature, DWORD cbSignerInfoCountersignature, DWORD dwSignerType, LPVOID pvSigner, DWORD dwFlags, LPVOID pvExtra)');
# my $ret = $CryptMsgVerifyCountersignatureEncodedEx->Call($hCryptProv, $dwEncodingType, $pbSignerInfo, $cbSignerInfo, $pbSignerInfoCountersignature, $cbSignerInfoCountersignature, $dwSignerType, $pvSigner, $dwFlags, $pvExtra);
# hCryptProv : HCRYPTPROV_LEGACY optional -> WPARAM
# dwEncodingType : DWORD -> DWORD
# pbSignerInfo : BYTE* -> LPVOID
# cbSignerInfo : DWORD -> DWORD
# pbSignerInfoCountersignature : BYTE* -> LPVOID
# cbSignerInfoCountersignature : DWORD -> DWORD
# dwSignerType : DWORD -> DWORD
# pvSigner : void* -> LPVOID
# dwFlags : DWORD -> DWORD
# pvExtra : void* optional, in/out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

関連項目

類似 API
公式の関連項目