CertFindCertificateInStore
関数シグネチャ
// CRYPT32.dll
#include <windows.h>
CERT_CONTEXT* CertFindCertificateInStore(
HCERTSTORE hCertStore,
CERT_QUERY_ENCODING_TYPE dwCertEncodingType,
DWORD dwFindFlags,
CERT_FIND_FLAGS dwFindType,
const void* pvFindPara, // optional
const CERT_CONTEXT* pPrevCertContext // optional
);パラメーター
| 名前 | 型 | 方向 | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hCertStore | HCERTSTORE | in | 検索対象となる 証明書ストア のハンドル。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| dwCertEncodingType | CERT_QUERY_ENCODING_TYPE | in | 使用するエンコードの種類を指定します。証明書のエンコードの種類と メッセージのエンコードの種類 の両方を、次の例のようにビット単位の OR 演算で組み合わせて指定する必要があります。 X509_ASN_ENCODING | PKCS_7_ASN_ENCODING 現在定義されているエンコードの種類は次のとおりです。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| dwFindFlags | DWORD | in | 一部の dwFindType の値とともに使用し、検索条件を変更します。ほとんどの dwFindType の値では dwFindFlags は使用されず、0 を設定する必要があります。詳細については「解説」を参照してください。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| dwFindType | CERT_FIND_FLAGS | in | 実行する検索の種類を指定します。検索の種類によって、pvFindPara のデータ型、内容、および用途が決まります。このパラメーターには、次のいずれかの値を指定できます。
注 dwFindType の値には、pvFindPara に文字列を渡す代替形式があります。一方の形式は Unicode 文字列を使用し、もう一方は ASCII 文字列を使用します。"_W" で終わる値またはサフィックスのない値は Unicode を使用します。"_A" で終わる値は ASCII 文字列を使用します。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pvFindPara | void* | inoptional | dwFindType とともに使用されるデータ項目または構造体を指します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| pPrevCertContext | CERT_CONTEXT* | inoptional | この関数が前回返した CERT_CONTEXT 構造体へのポインター。このパラメーターは、関数の最初の呼び出しでは NULL でなければなりません。検索条件を満たす後続の証明書を検索するには、前回の関数呼び出しで返されたポインターを pPrevCertContext に設定します。この関数は、このパラメーターが NULL 以外の値の場合、参照されている CERT_CONTEXT を解放します。 |
戻り値の型: CERT_CONTEXT*
公式ドキュメント
dwFindType およびそれに関連する pvFindPara によって指定された検索条件に一致する、証明書ストア内の最初または次の証明書コンテキストを検索します。
戻り値
関数が成功した場合、読み取り専用の CERT_CONTEXT 構造体へのポインターを返します。
関数が失敗し、検索条件に一致する証明書が見つからなかった場合、戻り値は NULL です。
CertFindCertificateInStore が返した NULL 以外の CERT_CONTEXT は、 CertFreeCertificateContext によって解放するか、後続の CertFindCertificateInStore 呼び出しの pPrevCertContext パラメーターとして渡すことで解放する必要があります。
拡張エラー情報を取得するには、 GetLastError を呼び出します。考えられるエラーコードの一部を次に示します。
| 戻り値コード | 説明 |
|---|---|
| 検索条件に一致する証明書が見つかりませんでした。これは、ストアが空である場合、またはストアのリストの末尾に達した場合に発生する可能性があります。 | |
| hCertStore パラメーター内のハンドルが、pPrevCertContext パラメーターが指す証明書 コンテキスト 内のハンドルと同じでないか、または dwFindType パラメーターに無効な値が指定されました。 |
解説(Remarks)
dwFindFlags パラメーターは、一部の検索の種類の条件を変更するために使用されます。
CERT_UNICODE_IS_RDN_ATTRS_FLAG という dwFindFlags の値は、dwFindType の CERT_FIND_SUBJECT_ATTR および CERT_FIND_ISSUER_ATTR の値とのみ併用されます。pvFindPara が指す CERT_RDN_ATTR 構造体が Unicode 文字列で初期化されている場合は、CERT_UNICODE_IS_RDN_ATTRS_FLAG を設定する必要があります。比較が行われる前に、Unicode 比較を行えるように、一致対象の文字列が X509_UNICODE_NAME を使用して変換されます。
次の dwFindFlags の値は、dwFindType の CERT_FIND_ENKEY_USAGE の値とのみ併用されます。
CertDuplicateCertificateContext を呼び出すと、返されたコンテキストの複製を作成できます。返されたコンテキストは、 CertAddCertificateContextToStore を使用して別の 証明書ストア に追加できます。また、 CertAddCertificateLinkToStore を使用して、コレクションストアではないストアに、その証明書コンテキストへのリンクを追加できます。
返されたポインターは、後続の関数呼び出しの pPrevCertContext パラメーターとして渡されたときに解放されます。それ以外の場合は、 CertFreeCertificateContext を呼び出して明示的にポインターを解放する必要があります。NULL 以外の pPrevCertContext は、関数内でエラーが発生した場合でも、CertFindCertificateInStore によって CertFreeCertificateContext の呼び出しを使用して常に解放されます。
例
次の例は、検索条件を満たす証明書コンテキストを証明書ストア内で検索する方法を示しています。この例のコンテキストを含む完全な例については、 Example C Program: Certificate Store Operations を参照してください。
この関数を使用する別の例については、Example C Program: Collection and Sibling Certificate Store Operations を参照してください。
#include <windows.h>
#include <stdio.h>
#include <Wincrypt.h>
#pragma comment(lib, "crypt32.lib")
#define MY_ENCODING_TYPE (PKCS_7_ASN_ENCODING | X509_ASN_ENCODING)
void main()
{
//-------------------------------------------------------------------
// Declare and initialize variables.
HCERTSTORE hSystemStore; // The system store handle.
PCCERT_CONTEXT pDesiredCert = NULL; // Set to NULL for the first
// call to
// CertFindCertificateInStore.
LPCSTR lpszCertSubject = (LPCSTR) "Cert_subject_1";
//-------------------------------------------------------------------
// Open the certificate store to be searched.
if(hSystemStore = CertOpenStore(
CERT_STORE_PROV_SYSTEM,
0, // Encoding type not needed
// with this PROV.
NULL, // Accept the default HCRYPTPROV.
CERT_SYSTEM_STORE_CURRENT_USER,
// Set the system store location in
// the registry.
L"MY")) // Could have used other predefined
// system stores
// including Trust, CA, or Root.
{
printf("Opened the MY system store. \n");
}
else
{
printf( "Could not open the MY system store.\n");
exit(1);
}
//-------------------------------------------------------------------
// Get a certificate that has lpszCertSubject as its
// subject.
if(pDesiredCert=CertFindCertificateInStore(
hSystemStore,
MY_ENCODING_TYPE, // Use X509_ASN_ENCODING.
0, // No dwFlags needed.
CERT_FIND_SUBJECT_STR, // Find a certificate with a
// subject that matches the string
// in the next parameter.
lpszCertSubject , // The Unicode string to be found
// in a certificate's subject.
NULL)) // NULL for the first call to the
// function. In all subsequent
// calls, it is the last pointer
// returned by the function.
{
printf("The desired certificate was found. \n");
}
else
{
printf("Could not find the desired certificate.\n");
}
//-------------------------------------------------------------------
// Clean up.
if(pDesiredCert)
CertFreeCertificateContext(pDesiredCert);
if(hSystemStore)
CertCloseStore(
hSystemStore,
CERT_CLOSE_STORE_CHECK_FLAG);
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// CRYPT32.dll
#include <windows.h>
CERT_CONTEXT* CertFindCertificateInStore(
HCERTSTORE hCertStore,
CERT_QUERY_ENCODING_TYPE dwCertEncodingType,
DWORD dwFindFlags,
CERT_FIND_FLAGS dwFindType,
const void* pvFindPara, // optional
const CERT_CONTEXT* pPrevCertContext // optional
);[DllImport("CRYPT32.dll", SetLastError = true, ExactSpelling = true)]
static extern IntPtr CertFindCertificateInStore(
IntPtr hCertStore, // HCERTSTORE
uint dwCertEncodingType, // CERT_QUERY_ENCODING_TYPE
uint dwFindFlags, // DWORD
uint dwFindType, // CERT_FIND_FLAGS
IntPtr pvFindPara, // void* optional
IntPtr pPrevCertContext // CERT_CONTEXT* optional
);<DllImport("CRYPT32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CertFindCertificateInStore(
hCertStore As IntPtr, ' HCERTSTORE
dwCertEncodingType As UInteger, ' CERT_QUERY_ENCODING_TYPE
dwFindFlags As UInteger, ' DWORD
dwFindType As UInteger, ' CERT_FIND_FLAGS
pvFindPara As IntPtr, ' void* optional
pPrevCertContext As IntPtr ' CERT_CONTEXT* optional
) As IntPtr
End Function' hCertStore : HCERTSTORE
' dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
' dwFindFlags : DWORD
' dwFindType : CERT_FIND_FLAGS
' pvFindPara : void* optional
' pPrevCertContext : CERT_CONTEXT* optional
Declare PtrSafe Function CertFindCertificateInStore Lib "crypt32" ( _
ByVal hCertStore As LongPtr, _
ByVal dwCertEncodingType As Long, _
ByVal dwFindFlags As Long, _
ByVal dwFindType As Long, _
ByVal pvFindPara As LongPtr, _
ByVal pPrevCertContext As LongPtr) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
CertFindCertificateInStore = ctypes.windll.crypt32.CertFindCertificateInStore
CertFindCertificateInStore.restype = ctypes.c_void_p
CertFindCertificateInStore.argtypes = [
wintypes.HANDLE, # hCertStore : HCERTSTORE
wintypes.DWORD, # dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
wintypes.DWORD, # dwFindFlags : DWORD
wintypes.DWORD, # dwFindType : CERT_FIND_FLAGS
ctypes.POINTER(None), # pvFindPara : void* optional
ctypes.c_void_p, # pPrevCertContext : CERT_CONTEXT* optional
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('CRYPT32.dll')
CertFindCertificateInStore = Fiddle::Function.new(
lib['CertFindCertificateInStore'],
[
Fiddle::TYPE_VOIDP, # hCertStore : HCERTSTORE
-Fiddle::TYPE_INT, # dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
-Fiddle::TYPE_INT, # dwFindFlags : DWORD
-Fiddle::TYPE_INT, # dwFindType : CERT_FIND_FLAGS
Fiddle::TYPE_VOIDP, # pvFindPara : void* optional
Fiddle::TYPE_VOIDP, # pPrevCertContext : CERT_CONTEXT* optional
],
Fiddle::TYPE_VOIDP)#[link(name = "crypt32")]
extern "system" {
fn CertFindCertificateInStore(
hCertStore: *mut core::ffi::c_void, // HCERTSTORE
dwCertEncodingType: u32, // CERT_QUERY_ENCODING_TYPE
dwFindFlags: u32, // DWORD
dwFindType: u32, // CERT_FIND_FLAGS
pvFindPara: *const (), // void* optional
pPrevCertContext: *const CERT_CONTEXT // CERT_CONTEXT* optional
) -> *mut CERT_CONTEXT;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("CRYPT32.dll", SetLastError = true)]
public static extern IntPtr CertFindCertificateInStore(IntPtr hCertStore, uint dwCertEncodingType, uint dwFindFlags, uint dwFindType, IntPtr pvFindPara, IntPtr pPrevCertContext);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CertFindCertificateInStore' -Namespace Win32 -PassThru
# $api::CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext)#uselib "CRYPT32.dll"
#func global CertFindCertificateInStore "CertFindCertificateInStore" sptr, sptr, sptr, sptr, sptr, sptr
; CertFindCertificateInStore hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, varptr(pPrevCertContext) ; 戻り値は stat
; hCertStore : HCERTSTORE -> "sptr"
; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "sptr"
; dwFindFlags : DWORD -> "sptr"
; dwFindType : CERT_FIND_FLAGS -> "sptr"
; pvFindPara : void* optional -> "sptr"
; pPrevCertContext : CERT_CONTEXT* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "CRYPT32.dll" #cfunc global CertFindCertificateInStore "CertFindCertificateInStore" sptr, int, int, int, sptr, var ; res = CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext) ; hCertStore : HCERTSTORE -> "sptr" ; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int" ; dwFindFlags : DWORD -> "int" ; dwFindType : CERT_FIND_FLAGS -> "int" ; pvFindPara : void* optional -> "sptr" ; pPrevCertContext : CERT_CONTEXT* optional -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "CRYPT32.dll" #cfunc global CertFindCertificateInStore "CertFindCertificateInStore" sptr, int, int, int, sptr, sptr ; res = CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, varptr(pPrevCertContext)) ; hCertStore : HCERTSTORE -> "sptr" ; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int" ; dwFindFlags : DWORD -> "int" ; dwFindType : CERT_FIND_FLAGS -> "int" ; pvFindPara : void* optional -> "sptr" ; pPrevCertContext : CERT_CONTEXT* optional -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; CERT_CONTEXT* CertFindCertificateInStore(HCERTSTORE hCertStore, CERT_QUERY_ENCODING_TYPE dwCertEncodingType, DWORD dwFindFlags, CERT_FIND_FLAGS dwFindType, void* pvFindPara, CERT_CONTEXT* pPrevCertContext) #uselib "CRYPT32.dll" #cfunc global CertFindCertificateInStore "CertFindCertificateInStore" intptr, int, int, int, intptr, var ; res = CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext) ; hCertStore : HCERTSTORE -> "intptr" ; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int" ; dwFindFlags : DWORD -> "int" ; dwFindType : CERT_FIND_FLAGS -> "int" ; pvFindPara : void* optional -> "intptr" ; pPrevCertContext : CERT_CONTEXT* optional -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; CERT_CONTEXT* CertFindCertificateInStore(HCERTSTORE hCertStore, CERT_QUERY_ENCODING_TYPE dwCertEncodingType, DWORD dwFindFlags, CERT_FIND_FLAGS dwFindType, void* pvFindPara, CERT_CONTEXT* pPrevCertContext) #uselib "CRYPT32.dll" #cfunc global CertFindCertificateInStore "CertFindCertificateInStore" intptr, int, int, int, intptr, intptr ; res = CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, varptr(pPrevCertContext)) ; hCertStore : HCERTSTORE -> "intptr" ; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int" ; dwFindFlags : DWORD -> "int" ; dwFindType : CERT_FIND_FLAGS -> "int" ; pvFindPara : void* optional -> "intptr" ; pPrevCertContext : CERT_CONTEXT* optional -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
crypt32 = windows.NewLazySystemDLL("CRYPT32.dll")
procCertFindCertificateInStore = crypt32.NewProc("CertFindCertificateInStore")
)
// hCertStore (HCERTSTORE), dwCertEncodingType (CERT_QUERY_ENCODING_TYPE), dwFindFlags (DWORD), dwFindType (CERT_FIND_FLAGS), pvFindPara (void* optional), pPrevCertContext (CERT_CONTEXT* optional)
r1, _, err := procCertFindCertificateInStore.Call(
uintptr(hCertStore),
uintptr(dwCertEncodingType),
uintptr(dwFindFlags),
uintptr(dwFindType),
uintptr(pvFindPara),
uintptr(pPrevCertContext),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // CERT_CONTEXT*function CertFindCertificateInStore(
hCertStore: THandle; // HCERTSTORE
dwCertEncodingType: DWORD; // CERT_QUERY_ENCODING_TYPE
dwFindFlags: DWORD; // DWORD
dwFindType: DWORD; // CERT_FIND_FLAGS
pvFindPara: Pointer; // void* optional
pPrevCertContext: Pointer // CERT_CONTEXT* optional
): Pointer; stdcall;
external 'CRYPT32.dll' name 'CertFindCertificateInStore';result := DllCall("CRYPT32\CertFindCertificateInStore"
, "Ptr", hCertStore ; HCERTSTORE
, "UInt", dwCertEncodingType ; CERT_QUERY_ENCODING_TYPE
, "UInt", dwFindFlags ; DWORD
, "UInt", dwFindType ; CERT_FIND_FLAGS
, "Ptr", pvFindPara ; void* optional
, "Ptr", pPrevCertContext ; CERT_CONTEXT* optional
, "Ptr") ; return: CERT_CONTEXT*●CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext) = DLL("CRYPT32.dll", "void* CertFindCertificateInStore(void*, dword, dword, dword, void*, void*)")
# 呼び出し: CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext)
# hCertStore : HCERTSTORE -> "void*"
# dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "dword"
# dwFindFlags : DWORD -> "dword"
# dwFindType : CERT_FIND_FLAGS -> "dword"
# pvFindPara : void* optional -> "void*"
# pPrevCertContext : CERT_CONTEXT* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "crypt32" fn CertFindCertificateInStore(
hCertStore: ?*anyopaque, // HCERTSTORE
dwCertEncodingType: u32, // CERT_QUERY_ENCODING_TYPE
dwFindFlags: u32, // DWORD
dwFindType: u32, // CERT_FIND_FLAGS
pvFindPara: ?*anyopaque, // void* optional
pPrevCertContext: [*c]CERT_CONTEXT // CERT_CONTEXT* optional
) callconv(std.os.windows.WINAPI) [*c]CERT_CONTEXT;proc CertFindCertificateInStore(
hCertStore: pointer, # HCERTSTORE
dwCertEncodingType: uint32, # CERT_QUERY_ENCODING_TYPE
dwFindFlags: uint32, # DWORD
dwFindType: uint32, # CERT_FIND_FLAGS
pvFindPara: pointer, # void* optional
pPrevCertContext: ptr CERT_CONTEXT # CERT_CONTEXT* optional
): ptr CERT_CONTEXT {.importc: "CertFindCertificateInStore", stdcall, dynlib: "CRYPT32.dll".}pragma(lib, "crypt32");
extern(Windows)
CERT_CONTEXT* CertFindCertificateInStore(
void* hCertStore, // HCERTSTORE
uint dwCertEncodingType, // CERT_QUERY_ENCODING_TYPE
uint dwFindFlags, // DWORD
uint dwFindType, // CERT_FIND_FLAGS
void* pvFindPara, // void* optional
CERT_CONTEXT* pPrevCertContext // CERT_CONTEXT* optional
);ccall((:CertFindCertificateInStore, "CRYPT32.dll"), stdcall, Ptr{CERT_CONTEXT},
(Ptr{Cvoid}, UInt32, UInt32, UInt32, Ptr{Cvoid}, Ptr{CERT_CONTEXT}),
hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext)
# hCertStore : HCERTSTORE -> Ptr{Cvoid}
# dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> UInt32
# dwFindFlags : DWORD -> UInt32
# dwFindType : CERT_FIND_FLAGS -> UInt32
# pvFindPara : void* optional -> Ptr{Cvoid}
# pPrevCertContext : CERT_CONTEXT* optional -> Ptr{CERT_CONTEXT}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
void* CertFindCertificateInStore(
void* hCertStore,
uint32_t dwCertEncodingType,
uint32_t dwFindFlags,
uint32_t dwFindType,
void* pvFindPara,
void* pPrevCertContext);
]]
local crypt32 = ffi.load("crypt32")
-- crypt32.CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext)
-- hCertStore : HCERTSTORE
-- dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
-- dwFindFlags : DWORD
-- dwFindType : CERT_FIND_FLAGS
-- pvFindPara : void* optional
-- pPrevCertContext : CERT_CONTEXT* optional
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('CRYPT32.dll');
const CertFindCertificateInStore = lib.func('__stdcall', 'CertFindCertificateInStore', 'void *', ['void *', 'uint32_t', 'uint32_t', 'uint32_t', 'void *', 'void *']);
// CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext)
// hCertStore : HCERTSTORE -> 'void *'
// dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> 'uint32_t'
// dwFindFlags : DWORD -> 'uint32_t'
// dwFindType : CERT_FIND_FLAGS -> 'uint32_t'
// pvFindPara : void* optional -> 'void *'
// pPrevCertContext : CERT_CONTEXT* optional -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("CRYPT32.dll", {
CertFindCertificateInStore: { parameters: ["pointer", "u32", "u32", "u32", "pointer", "pointer"], result: "pointer" },
});
// lib.symbols.CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext)
// hCertStore : HCERTSTORE -> "pointer"
// dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "u32"
// dwFindFlags : DWORD -> "u32"
// dwFindType : CERT_FIND_FLAGS -> "u32"
// pvFindPara : void* optional -> "pointer"
// pPrevCertContext : CERT_CONTEXT* optional -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
void* CertFindCertificateInStore(
void* hCertStore,
uint32_t dwCertEncodingType,
uint32_t dwFindFlags,
uint32_t dwFindType,
void* pvFindPara,
void* pPrevCertContext);
C, "CRYPT32.dll");
// $ffi->CertFindCertificateInStore(hCertStore, dwCertEncodingType, dwFindFlags, dwFindType, pvFindPara, pPrevCertContext);
// hCertStore : HCERTSTORE
// dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
// dwFindFlags : DWORD
// dwFindType : CERT_FIND_FLAGS
// pvFindPara : void* optional
// pPrevCertContext : CERT_CONTEXT* 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 Crypt32 extends StdCallLibrary {
Crypt32 INSTANCE = Native.load("crypt32", Crypt32.class);
Pointer CertFindCertificateInStore(
Pointer hCertStore, // HCERTSTORE
int dwCertEncodingType, // CERT_QUERY_ENCODING_TYPE
int dwFindFlags, // DWORD
int dwFindType, // CERT_FIND_FLAGS
Pointer pvFindPara, // void* optional
Pointer pPrevCertContext // CERT_CONTEXT* optional
);
}@[Link("crypt32")]
lib LibCRYPT32
fun CertFindCertificateInStore = CertFindCertificateInStore(
hCertStore : Void*, # HCERTSTORE
dwCertEncodingType : UInt32, # CERT_QUERY_ENCODING_TYPE
dwFindFlags : UInt32, # DWORD
dwFindType : UInt32, # CERT_FIND_FLAGS
pvFindPara : Void*, # void* optional
pPrevCertContext : CERT_CONTEXT* # CERT_CONTEXT* optional
) : CERT_CONTEXT*
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef CertFindCertificateInStoreNative = Pointer<Void> Function(Pointer<Void>, Uint32, Uint32, Uint32, Pointer<Void>, Pointer<Void>);
typedef CertFindCertificateInStoreDart = Pointer<Void> Function(Pointer<Void>, int, int, int, Pointer<Void>, Pointer<Void>);
final CertFindCertificateInStore = DynamicLibrary.open('CRYPT32.dll')
.lookupFunction<CertFindCertificateInStoreNative, CertFindCertificateInStoreDart>('CertFindCertificateInStore');
// hCertStore : HCERTSTORE -> Pointer<Void>
// dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> Uint32
// dwFindFlags : DWORD -> Uint32
// dwFindType : CERT_FIND_FLAGS -> Uint32
// pvFindPara : void* optional -> Pointer<Void>
// pPrevCertContext : CERT_CONTEXT* optional -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function CertFindCertificateInStore(
hCertStore: THandle; // HCERTSTORE
dwCertEncodingType: DWORD; // CERT_QUERY_ENCODING_TYPE
dwFindFlags: DWORD; // DWORD
dwFindType: DWORD; // CERT_FIND_FLAGS
pvFindPara: Pointer; // void* optional
pPrevCertContext: Pointer // CERT_CONTEXT* optional
): Pointer; stdcall;
external 'CRYPT32.dll' name 'CertFindCertificateInStore';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "CertFindCertificateInStore"
c_CertFindCertificateInStore :: Ptr () -> Word32 -> Word32 -> Word32 -> Ptr () -> Ptr () -> IO (Ptr ())
-- hCertStore : HCERTSTORE -> Ptr ()
-- dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> Word32
-- dwFindFlags : DWORD -> Word32
-- dwFindType : CERT_FIND_FLAGS -> Word32
-- pvFindPara : void* optional -> Ptr ()
-- pPrevCertContext : CERT_CONTEXT* optional -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let certfindcertificateinstore =
foreign "CertFindCertificateInStore"
((ptr void) @-> uint32_t @-> uint32_t @-> uint32_t @-> (ptr void) @-> (ptr void) @-> returning (ptr void))
(* hCertStore : HCERTSTORE -> (ptr void) *)
(* dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> uint32_t *)
(* dwFindFlags : DWORD -> uint32_t *)
(* dwFindType : CERT_FIND_FLAGS -> uint32_t *)
(* pvFindPara : void* optional -> (ptr void) *)
(* pPrevCertContext : CERT_CONTEXT* optional -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library crypt32 (t "CRYPT32.dll"))
(cffi:use-foreign-library crypt32)
(cffi:defcfun ("CertFindCertificateInStore" cert-find-certificate-in-store :convention :stdcall) :pointer
(h-cert-store :pointer) ; HCERTSTORE
(dw-cert-encoding-type :uint32) ; CERT_QUERY_ENCODING_TYPE
(dw-find-flags :uint32) ; DWORD
(dw-find-type :uint32) ; CERT_FIND_FLAGS
(pv-find-para :pointer) ; void* optional
(p-prev-cert-context :pointer)) ; CERT_CONTEXT* optional
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $CertFindCertificateInStore = Win32::API::More->new('CRYPT32',
'LPVOID CertFindCertificateInStore(HANDLE hCertStore, DWORD dwCertEncodingType, DWORD dwFindFlags, DWORD dwFindType, LPVOID pvFindPara, LPVOID pPrevCertContext)');
# my $ret = $CertFindCertificateInStore->Call($hCertStore, $dwCertEncodingType, $dwFindFlags, $dwFindType, $pvFindPara, $pPrevCertContext);
# hCertStore : HCERTSTORE -> HANDLE
# dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> DWORD
# dwFindFlags : DWORD -> DWORD
# dwFindType : CERT_FIND_FLAGS -> DWORD
# pvFindPara : void* optional -> LPVOID
# pPrevCertContext : CERT_CONTEXT* optional -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
- f CertAddCertificateContextToStore — 証明書コンテキストをストアに追加する。
- f CertAddCertificateLinkToStore — 別ストアの証明書へのリンクをストアに追加する。
- f CertDuplicateCertificateContext — 証明書コンテキストを複製して参照を増やす。
- f CertEnumCertificatesInStore — 証明書ストア内の証明書を順に列挙する。
- f CertFreeCertificateContext — 証明書コンテキストを解放する。
- f CertGetCertificateChain — 証明書から信頼ルートまでの証明書チェーンを構築する。
- f CertNameToStrW — エンコードされた証明書名をUnicodeのX.500文字列に変換する。