ホーム › Security.Cryptography › SignerTimeStamp
SignerTimeStamp
関数署名済みオブジェクトにタイムスタンプを付与する。
シグネチャ
// Mssign32.dll
#include <windows.h>
HRESULT SignerTimeStamp(
SIGNER_SUBJECT_INFO* pSubjectInfo,
LPCWSTR pwszHttpTimeStamp,
CRYPT_ATTRIBUTES* psRequest, // optional
void* pSipData // optional
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| pSubjectInfo | SIGNER_SUBJECT_INFO* | in | タイムスタンプ対象を記述するSIGNER_SUBJECT_INFO構造体。 |
| pwszHttpTimeStamp | LPCWSTR | in | タイムスタンプサーバのHTTP URL。 |
| psRequest | CRYPT_ATTRIBUTES* | inoptional | タイムスタンプに追加する認証属性を示すCRYPT_ATTRIBUTES。NULL可。 |
| pSipData | void* | inoptional | SIPプロバイダへ渡す任意のデータへのポインタ。通常NULL可。 |
戻り値の型: HRESULT
各言語での呼び出し定義
// Mssign32.dll
#include <windows.h>
HRESULT SignerTimeStamp(
SIGNER_SUBJECT_INFO* pSubjectInfo,
LPCWSTR pwszHttpTimeStamp,
CRYPT_ATTRIBUTES* psRequest, // optional
void* pSipData // optional
);[DllImport("Mssign32.dll", ExactSpelling = true)]
static extern int SignerTimeStamp(
IntPtr pSubjectInfo, // SIGNER_SUBJECT_INFO*
[MarshalAs(UnmanagedType.LPWStr)] string pwszHttpTimeStamp, // LPCWSTR
IntPtr psRequest, // CRYPT_ATTRIBUTES* optional
IntPtr pSipData // void* optional
);<DllImport("Mssign32.dll", ExactSpelling:=True)>
Public Shared Function SignerTimeStamp(
pSubjectInfo As IntPtr, ' SIGNER_SUBJECT_INFO*
<MarshalAs(UnmanagedType.LPWStr)> pwszHttpTimeStamp As String, ' LPCWSTR
psRequest As IntPtr, ' CRYPT_ATTRIBUTES* optional
pSipData As IntPtr ' void* optional
) As Integer
End Function' pSubjectInfo : SIGNER_SUBJECT_INFO*
' pwszHttpTimeStamp : LPCWSTR
' psRequest : CRYPT_ATTRIBUTES* optional
' pSipData : void* optional
Declare PtrSafe Function SignerTimeStamp Lib "mssign32" ( _
ByVal pSubjectInfo As LongPtr, _
ByVal pwszHttpTimeStamp As LongPtr, _
ByVal psRequest As LongPtr, _
ByVal pSipData As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
SignerTimeStamp = ctypes.windll.mssign32.SignerTimeStamp
SignerTimeStamp.restype = ctypes.c_int
SignerTimeStamp.argtypes = [
ctypes.c_void_p, # pSubjectInfo : SIGNER_SUBJECT_INFO*
wintypes.LPCWSTR, # pwszHttpTimeStamp : LPCWSTR
ctypes.c_void_p, # psRequest : CRYPT_ATTRIBUTES* optional
ctypes.POINTER(None), # pSipData : void* optional
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('Mssign32.dll')
SignerTimeStamp = Fiddle::Function.new(
lib['SignerTimeStamp'],
[
Fiddle::TYPE_VOIDP, # pSubjectInfo : SIGNER_SUBJECT_INFO*
Fiddle::TYPE_VOIDP, # pwszHttpTimeStamp : LPCWSTR
Fiddle::TYPE_VOIDP, # psRequest : CRYPT_ATTRIBUTES* optional
Fiddle::TYPE_VOIDP, # pSipData : void* optional
],
Fiddle::TYPE_INT)#[link(name = "mssign32")]
extern "system" {
fn SignerTimeStamp(
pSubjectInfo: *mut SIGNER_SUBJECT_INFO, // SIGNER_SUBJECT_INFO*
pwszHttpTimeStamp: *const u16, // LPCWSTR
psRequest: *mut CRYPT_ATTRIBUTES, // CRYPT_ATTRIBUTES* optional
pSipData: *mut () // void* optional
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("Mssign32.dll")]
public static extern int SignerTimeStamp(IntPtr pSubjectInfo, [MarshalAs(UnmanagedType.LPWStr)] string pwszHttpTimeStamp, IntPtr psRequest, IntPtr pSipData);
"@
$api = Add-Type -MemberDefinition $sig -Name 'Mssign32_SignerTimeStamp' -Namespace Win32 -PassThru
# $api::SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData)#uselib "Mssign32.dll"
#func global SignerTimeStamp "SignerTimeStamp" sptr, sptr, sptr, sptr
; SignerTimeStamp varptr(pSubjectInfo), pwszHttpTimeStamp, varptr(psRequest), pSipData ; 戻り値は stat
; pSubjectInfo : SIGNER_SUBJECT_INFO* -> "sptr"
; pwszHttpTimeStamp : LPCWSTR -> "sptr"
; psRequest : CRYPT_ATTRIBUTES* optional -> "sptr"
; pSipData : void* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "Mssign32.dll" #cfunc global SignerTimeStamp "SignerTimeStamp" var, wstr, var, sptr ; res = SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData) ; pSubjectInfo : SIGNER_SUBJECT_INFO* -> "var" ; pwszHttpTimeStamp : LPCWSTR -> "wstr" ; psRequest : CRYPT_ATTRIBUTES* optional -> "var" ; pSipData : void* optional -> "sptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "Mssign32.dll" #cfunc global SignerTimeStamp "SignerTimeStamp" sptr, wstr, sptr, sptr ; res = SignerTimeStamp(varptr(pSubjectInfo), pwszHttpTimeStamp, varptr(psRequest), pSipData) ; pSubjectInfo : SIGNER_SUBJECT_INFO* -> "sptr" ; pwszHttpTimeStamp : LPCWSTR -> "wstr" ; psRequest : CRYPT_ATTRIBUTES* optional -> "sptr" ; pSipData : void* optional -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HRESULT SignerTimeStamp(SIGNER_SUBJECT_INFO* pSubjectInfo, LPCWSTR pwszHttpTimeStamp, CRYPT_ATTRIBUTES* psRequest, void* pSipData) #uselib "Mssign32.dll" #cfunc global SignerTimeStamp "SignerTimeStamp" var, wstr, var, intptr ; res = SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData) ; pSubjectInfo : SIGNER_SUBJECT_INFO* -> "var" ; pwszHttpTimeStamp : LPCWSTR -> "wstr" ; psRequest : CRYPT_ATTRIBUTES* optional -> "var" ; pSipData : void* optional -> "intptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT SignerTimeStamp(SIGNER_SUBJECT_INFO* pSubjectInfo, LPCWSTR pwszHttpTimeStamp, CRYPT_ATTRIBUTES* psRequest, void* pSipData) #uselib "Mssign32.dll" #cfunc global SignerTimeStamp "SignerTimeStamp" intptr, wstr, intptr, intptr ; res = SignerTimeStamp(varptr(pSubjectInfo), pwszHttpTimeStamp, varptr(psRequest), pSipData) ; pSubjectInfo : SIGNER_SUBJECT_INFO* -> "intptr" ; pwszHttpTimeStamp : LPCWSTR -> "wstr" ; psRequest : CRYPT_ATTRIBUTES* optional -> "intptr" ; pSipData : void* optional -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
mssign32 = windows.NewLazySystemDLL("Mssign32.dll")
procSignerTimeStamp = mssign32.NewProc("SignerTimeStamp")
)
// pSubjectInfo (SIGNER_SUBJECT_INFO*), pwszHttpTimeStamp (LPCWSTR), psRequest (CRYPT_ATTRIBUTES* optional), pSipData (void* optional)
r1, _, err := procSignerTimeStamp.Call(
uintptr(pSubjectInfo),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pwszHttpTimeStamp))),
uintptr(psRequest),
uintptr(pSipData),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction SignerTimeStamp(
pSubjectInfo: Pointer; // SIGNER_SUBJECT_INFO*
pwszHttpTimeStamp: PWideChar; // LPCWSTR
psRequest: Pointer; // CRYPT_ATTRIBUTES* optional
pSipData: Pointer // void* optional
): Integer; stdcall;
external 'Mssign32.dll' name 'SignerTimeStamp';result := DllCall("Mssign32\SignerTimeStamp"
, "Ptr", pSubjectInfo ; SIGNER_SUBJECT_INFO*
, "WStr", pwszHttpTimeStamp ; LPCWSTR
, "Ptr", psRequest ; CRYPT_ATTRIBUTES* optional
, "Ptr", pSipData ; void* optional
, "Int") ; return: HRESULT●SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData) = DLL("Mssign32.dll", "int SignerTimeStamp(void*, char*, void*, void*)")
# 呼び出し: SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData)
# pSubjectInfo : SIGNER_SUBJECT_INFO* -> "void*"
# pwszHttpTimeStamp : LPCWSTR -> "char*"
# psRequest : CRYPT_ATTRIBUTES* optional -> "void*"
# pSipData : void* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "mssign32" fn SignerTimeStamp(
pSubjectInfo: [*c]SIGNER_SUBJECT_INFO, // SIGNER_SUBJECT_INFO*
pwszHttpTimeStamp: [*c]const u16, // LPCWSTR
psRequest: [*c]CRYPT_ATTRIBUTES, // CRYPT_ATTRIBUTES* optional
pSipData: ?*anyopaque // void* optional
) callconv(std.os.windows.WINAPI) i32;proc SignerTimeStamp(
pSubjectInfo: ptr SIGNER_SUBJECT_INFO, # SIGNER_SUBJECT_INFO*
pwszHttpTimeStamp: WideCString, # LPCWSTR
psRequest: ptr CRYPT_ATTRIBUTES, # CRYPT_ATTRIBUTES* optional
pSipData: pointer # void* optional
): int32 {.importc: "SignerTimeStamp", stdcall, dynlib: "Mssign32.dll".}pragma(lib, "mssign32");
extern(Windows)
int SignerTimeStamp(
SIGNER_SUBJECT_INFO* pSubjectInfo, // SIGNER_SUBJECT_INFO*
const(wchar)* pwszHttpTimeStamp, // LPCWSTR
CRYPT_ATTRIBUTES* psRequest, // CRYPT_ATTRIBUTES* optional
void* pSipData // void* optional
);ccall((:SignerTimeStamp, "Mssign32.dll"), stdcall, Int32,
(Ptr{SIGNER_SUBJECT_INFO}, Cwstring, Ptr{CRYPT_ATTRIBUTES}, Ptr{Cvoid}),
pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData)
# pSubjectInfo : SIGNER_SUBJECT_INFO* -> Ptr{SIGNER_SUBJECT_INFO}
# pwszHttpTimeStamp : LPCWSTR -> Cwstring
# psRequest : CRYPT_ATTRIBUTES* optional -> Ptr{CRYPT_ATTRIBUTES}
# pSipData : void* optional -> Ptr{Cvoid}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
int32_t SignerTimeStamp(
void* pSubjectInfo,
const uint16_t* pwszHttpTimeStamp,
void* psRequest,
void* pSipData);
]]
local mssign32 = ffi.load("mssign32")
-- mssign32.SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData)
-- pSubjectInfo : SIGNER_SUBJECT_INFO*
-- pwszHttpTimeStamp : LPCWSTR
-- psRequest : CRYPT_ATTRIBUTES* optional
-- pSipData : void* optional
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('Mssign32.dll');
const SignerTimeStamp = lib.func('__stdcall', 'SignerTimeStamp', 'int32_t', ['void *', 'str16', 'void *', 'void *']);
// SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData)
// pSubjectInfo : SIGNER_SUBJECT_INFO* -> 'void *'
// pwszHttpTimeStamp : LPCWSTR -> 'str16'
// psRequest : CRYPT_ATTRIBUTES* optional -> 'void *'
// pSipData : void* optional -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("Mssign32.dll", {
SignerTimeStamp: { parameters: ["pointer", "buffer", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData)
// pSubjectInfo : SIGNER_SUBJECT_INFO* -> "pointer"
// pwszHttpTimeStamp : LPCWSTR -> "buffer"
// psRequest : CRYPT_ATTRIBUTES* optional -> "pointer"
// pSipData : void* optional -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t SignerTimeStamp(
void* pSubjectInfo,
const uint16_t* pwszHttpTimeStamp,
void* psRequest,
void* pSipData);
C, "Mssign32.dll");
// $ffi->SignerTimeStamp(pSubjectInfo, pwszHttpTimeStamp, psRequest, pSipData);
// pSubjectInfo : SIGNER_SUBJECT_INFO*
// pwszHttpTimeStamp : LPCWSTR
// psRequest : CRYPT_ATTRIBUTES* optional
// pSipData : void* optional
// 構造体/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 Mssign32 extends StdCallLibrary {
Mssign32 INSTANCE = Native.load("mssign32", Mssign32.class);
int SignerTimeStamp(
Pointer pSubjectInfo, // SIGNER_SUBJECT_INFO*
WString pwszHttpTimeStamp, // LPCWSTR
Pointer psRequest, // CRYPT_ATTRIBUTES* optional
Pointer pSipData // void* optional
);
}@[Link("mssign32")]
lib LibMssign32
fun SignerTimeStamp = SignerTimeStamp(
pSubjectInfo : SIGNER_SUBJECT_INFO*, # SIGNER_SUBJECT_INFO*
pwszHttpTimeStamp : UInt16*, # LPCWSTR
psRequest : CRYPT_ATTRIBUTES*, # CRYPT_ATTRIBUTES* optional
pSipData : Void* # void* optional
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef SignerTimeStampNative = Int32 Function(Pointer<Void>, Pointer<Utf16>, Pointer<Void>, Pointer<Void>);
typedef SignerTimeStampDart = int Function(Pointer<Void>, Pointer<Utf16>, Pointer<Void>, Pointer<Void>);
final SignerTimeStamp = DynamicLibrary.open('Mssign32.dll')
.lookupFunction<SignerTimeStampNative, SignerTimeStampDart>('SignerTimeStamp');
// pSubjectInfo : SIGNER_SUBJECT_INFO* -> Pointer<Void>
// pwszHttpTimeStamp : LPCWSTR -> Pointer<Utf16>
// psRequest : CRYPT_ATTRIBUTES* optional -> Pointer<Void>
// pSipData : void* optional -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function SignerTimeStamp(
pSubjectInfo: Pointer; // SIGNER_SUBJECT_INFO*
pwszHttpTimeStamp: PWideChar; // LPCWSTR
psRequest: Pointer; // CRYPT_ATTRIBUTES* optional
pSipData: Pointer // void* optional
): Integer; stdcall;
external 'Mssign32.dll' name 'SignerTimeStamp';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "SignerTimeStamp"
c_SignerTimeStamp :: Ptr () -> CWString -> Ptr () -> Ptr () -> IO Int32
-- pSubjectInfo : SIGNER_SUBJECT_INFO* -> Ptr ()
-- pwszHttpTimeStamp : LPCWSTR -> CWString
-- psRequest : CRYPT_ATTRIBUTES* optional -> Ptr ()
-- pSipData : void* optional -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let signertimestamp =
foreign "SignerTimeStamp"
((ptr void) @-> (ptr uint16_t) @-> (ptr void) @-> (ptr void) @-> returning int32_t)
(* pSubjectInfo : SIGNER_SUBJECT_INFO* -> (ptr void) *)
(* pwszHttpTimeStamp : LPCWSTR -> (ptr uint16_t) *)
(* psRequest : CRYPT_ATTRIBUTES* optional -> (ptr void) *)
(* pSipData : void* optional -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library mssign32 (t "Mssign32.dll"))
(cffi:use-foreign-library mssign32)
(cffi:defcfun ("SignerTimeStamp" signer-time-stamp :convention :stdcall) :int32
(p-subject-info :pointer) ; SIGNER_SUBJECT_INFO*
(pwsz-http-time-stamp (:string :encoding :utf-16le)) ; LPCWSTR
(ps-request :pointer) ; CRYPT_ATTRIBUTES* optional
(p-sip-data :pointer)) ; void* optional
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $SignerTimeStamp = Win32::API::More->new('Mssign32',
'int SignerTimeStamp(LPVOID pSubjectInfo, LPCWSTR pwszHttpTimeStamp, LPVOID psRequest, LPVOID pSipData)');
# my $ret = $SignerTimeStamp->Call($pSubjectInfo, $pwszHttpTimeStamp, $psRequest, $pSipData);
# pSubjectInfo : SIGNER_SUBJECT_INFO* -> LPVOID
# pwszHttpTimeStamp : LPCWSTR -> LPCWSTR
# psRequest : CRYPT_ATTRIBUTES* optional -> LPVOID
# pSipData : void* optional -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
類似 API
- f SignerTimeStampEx — フラグと署名者コンテキスト付きでタイムスタンプを付与する。
- f SignerTimeStampEx2 — アルゴリズムを指定してRFC3161タイムスタンプを付与する。
- f SignerTimeStampEx3 — アルゴリズムOIDやポリシーを指定して拡張タイムスタンプを付与する。