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

CertOpenSystemStoreA

関数
システム証明書ストアをANSI名で開く。
DLLCRYPT32.dll文字セットANSI (-A)呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

// CRYPT32.dll  (ANSI / -A)
#include <windows.h>

HCERTSTORE CertOpenSystemStoreA(
    HCRYPTPROV_LEGACY hProv,   // optional
    LPCSTR szSubsystemProtocol
);

パラメーター

名前方向説明
hProvHCRYPTPROV_LEGACYinoptional

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

Windows Server 2003 および Windows XP: 暗号化サービス プロバイダー (CSP) のハンドル。既定の CSP を使用するには、hProv0 に設定します。hProv0 でない場合は、CryptAcquireContext 関数を使用して作成された CSP ハンドルである必要があります。このパラメーターのデータ型は HCRYPTPROV です。

szSubsystemProtocolLPCSTRin

システム ストアを指定する文字列。このパラメーターで指定したシステム ストア名が既存のシステム ストアの名前でない場合、新しいシステム ストアが作成されて使用されます。既存のシステム ストアの名前を列挙するには、CertEnumSystemStore を使用できます。システム ストアの例を次の表に示します。

意味
CA
証明機関の証明書。
MY
関連付けられた秘密キーを持つ証明書を保持する証明書ストア。
ROOT
ルート証明書
SPC
ソフトウェア発行元証明書

戻り値の型: HCERTSTORE

公式ドキュメント

最も一般的なシステム証明書ストアを開きます。ファイルベースやメモリベースのストアなど、より複雑な要件を持つ証明書ストアを開くには、CertOpenStore を使用してください。(ANSI)

戻り値

関数が成功すると、証明書ストアへのハンドルを返します。

関数が失敗すると、NULL を返します。拡張エラー情報を取得するには、GetLastError を呼び出してください。

注意 呼び出された CertOpenStore 関数からのエラーは、この関数に伝播されます。

解説(Remarks)

このメソッドでアクセスできるのは現在のユーザーの証明書のみであり、ローカル コンピューターのストアにはアクセスできません。

システム ストアを開いた後は、標準的な証明書ストア関数をすべて使用して証明書を操作できます。

使用後は、CertCloseStore を使用してストアを閉じる必要があります。

自動的に移行されるストアの詳細については、証明書ストアの移行を参照してください。

次の例は、最も一般的なシステム証明書ストアを開くための簡略化された方法を示しています。この関数を使用する別の例については、例: 証明書ストア操作の C プログラムを参照してください。

//--------------------------------------------------------------------
// 変数を宣言して初期化します。

HCERTSTORE  hSystemStore;              // システム ストアのハンドル

//--------------------------------------------------------------------
// CA システム証明書ストアを開きます。同じ呼び出しで、第 2 パラメーターに
// My や Root などの別のシステム ストアの名前を指定して使用することもできます。

if(hSystemStore = CertOpenSystemStore(
    0,
    "CA"))
{
  printf("The CA system store is open. Continue.\n");
}
else
{
  printf("The CA system store did not open.\n");
  exit(1);
}

// 必要に応じてストアを使用します。
// ...

// ストアの使用が終わったら、閉じます。
if(!CertCloseStore(hSystemStore, 0))
{
  printf("Unable to close the CA system store.\n");
  exit(1);
}
メモ

wincrypt.h ヘッダーは、CertOpenSystemStore を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義しています。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在して使用すると、不一致が生じ、コンパイル エラーや実行時エラーを引き起こす可能性があります。詳細については、関数プロトタイプの規則を参照してください。

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

各言語での呼び出し定義

// CRYPT32.dll  (ANSI / -A)
#include <windows.h>

HCERTSTORE CertOpenSystemStoreA(
    HCRYPTPROV_LEGACY hProv,   // optional
    LPCSTR szSubsystemProtocol
);
[DllImport("CRYPT32.dll", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
static extern IntPtr CertOpenSystemStoreA(
    UIntPtr hProv,   // HCRYPTPROV_LEGACY optional
    [MarshalAs(UnmanagedType.LPStr)] string szSubsystemProtocol   // LPCSTR
);
<DllImport("CRYPT32.dll", CharSet:=CharSet.Ansi, SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CertOpenSystemStoreA(
    hProv As UIntPtr,   ' HCRYPTPROV_LEGACY optional
    <MarshalAs(UnmanagedType.LPStr)> szSubsystemProtocol As String   ' LPCSTR
) As IntPtr
End Function
' hProv : HCRYPTPROV_LEGACY optional
' szSubsystemProtocol : LPCSTR
Declare PtrSafe Function CertOpenSystemStoreA Lib "crypt32" ( _
    ByVal hProv As LongPtr, _
    ByVal szSubsystemProtocol As String) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

CertOpenSystemStoreA = ctypes.windll.crypt32.CertOpenSystemStoreA
CertOpenSystemStoreA.restype = ctypes.c_void_p
CertOpenSystemStoreA.argtypes = [
    ctypes.c_size_t,  # hProv : HCRYPTPROV_LEGACY optional
    wintypes.LPCSTR,  # szSubsystemProtocol : LPCSTR
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CRYPT32.dll')
CertOpenSystemStoreA = Fiddle::Function.new(
  lib['CertOpenSystemStoreA'],
  [
    Fiddle::TYPE_UINTPTR_T,  # hProv : HCRYPTPROV_LEGACY optional
    Fiddle::TYPE_VOIDP,  # szSubsystemProtocol : LPCSTR
  ],
  Fiddle::TYPE_VOIDP)
#[link(name = "crypt32")]
extern "system" {
    fn CertOpenSystemStoreA(
        hProv: usize,  // HCRYPTPROV_LEGACY optional
        szSubsystemProtocol: *const u8  // LPCSTR
    ) -> *mut core::ffi::c_void;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("CRYPT32.dll", CharSet = CharSet.Ansi, SetLastError = true)]
public static extern IntPtr CertOpenSystemStoreA(UIntPtr hProv, [MarshalAs(UnmanagedType.LPStr)] string szSubsystemProtocol);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CertOpenSystemStoreA' -Namespace Win32 -PassThru
# $api::CertOpenSystemStoreA(hProv, szSubsystemProtocol)
#uselib "CRYPT32.dll"
#func global CertOpenSystemStoreA "CertOpenSystemStoreA" sptr, sptr
; CertOpenSystemStoreA hProv, szSubsystemProtocol   ; 戻り値は stat
; hProv : HCRYPTPROV_LEGACY optional -> "sptr"
; szSubsystemProtocol : LPCSTR -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
#uselib "CRYPT32.dll"
#cfunc global CertOpenSystemStoreA "CertOpenSystemStoreA" sptr, str
; res = CertOpenSystemStoreA(hProv, szSubsystemProtocol)
; hProv : HCRYPTPROV_LEGACY optional -> "sptr"
; szSubsystemProtocol : LPCSTR -> "str"
; HCERTSTORE CertOpenSystemStoreA(HCRYPTPROV_LEGACY hProv, LPCSTR szSubsystemProtocol)
#uselib "CRYPT32.dll"
#cfunc global CertOpenSystemStoreA "CertOpenSystemStoreA" intptr, str
; res = CertOpenSystemStoreA(hProv, szSubsystemProtocol)
; hProv : HCRYPTPROV_LEGACY optional -> "intptr"
; szSubsystemProtocol : LPCSTR -> "str"
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	crypt32 = windows.NewLazySystemDLL("CRYPT32.dll")
	procCertOpenSystemStoreA = crypt32.NewProc("CertOpenSystemStoreA")
)

// hProv (HCRYPTPROV_LEGACY optional), szSubsystemProtocol (LPCSTR)
r1, _, err := procCertOpenSystemStoreA.Call(
	uintptr(hProv),
	uintptr(unsafe.Pointer(windows.BytePtrFromString(szSubsystemProtocol))),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HCERTSTORE
function CertOpenSystemStoreA(
  hProv: NativeUInt;   // HCRYPTPROV_LEGACY optional
  szSubsystemProtocol: PAnsiChar   // LPCSTR
): THandle; stdcall;
  external 'CRYPT32.dll' name 'CertOpenSystemStoreA';
result := DllCall("CRYPT32\CertOpenSystemStoreA"
    , "UPtr", hProv   ; HCRYPTPROV_LEGACY optional
    , "AStr", szSubsystemProtocol   ; LPCSTR
    , "Ptr")   ; return: HCERTSTORE
●CertOpenSystemStoreA(hProv, szSubsystemProtocol) = DLL("CRYPT32.dll", "void* CertOpenSystemStoreA(int, char*)")
# 呼び出し: CertOpenSystemStoreA(hProv, szSubsystemProtocol)
# hProv : HCRYPTPROV_LEGACY optional -> "int"
# szSubsystemProtocol : LPCSTR -> "char*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "crypt32" fn CertOpenSystemStoreA(
    hProv: usize, // HCRYPTPROV_LEGACY optional
    szSubsystemProtocol: [*c]const u8 // LPCSTR
) callconv(std.os.windows.WINAPI) ?*anyopaque;
proc CertOpenSystemStoreA(
    hProv: uint,  # HCRYPTPROV_LEGACY optional
    szSubsystemProtocol: cstring  # LPCSTR
): pointer {.importc: "CertOpenSystemStoreA", stdcall, dynlib: "CRYPT32.dll".}
pragma(lib, "crypt32");
extern(Windows)
void* CertOpenSystemStoreA(
    size_t hProv,   // HCRYPTPROV_LEGACY optional
    const(char)* szSubsystemProtocol   // LPCSTR
);
ccall((:CertOpenSystemStoreA, "CRYPT32.dll"), stdcall, Ptr{Cvoid},
      (Csize_t, Cstring),
      hProv, szSubsystemProtocol)
# hProv : HCRYPTPROV_LEGACY optional -> Csize_t
# szSubsystemProtocol : LPCSTR -> Cstring
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
void* CertOpenSystemStoreA(
    uintptr_t hProv,
    const char* szSubsystemProtocol);
]]
local crypt32 = ffi.load("crypt32")
-- crypt32.CertOpenSystemStoreA(hProv, szSubsystemProtocol)
-- hProv : HCRYPTPROV_LEGACY optional
-- szSubsystemProtocol : LPCSTR
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('CRYPT32.dll');
const CertOpenSystemStoreA = lib.func('__stdcall', 'CertOpenSystemStoreA', 'void *', ['uintptr_t', 'str']);
// CertOpenSystemStoreA(hProv, szSubsystemProtocol)
// hProv : HCRYPTPROV_LEGACY optional -> 'uintptr_t'
// szSubsystemProtocol : LPCSTR -> 'str'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("CRYPT32.dll", {
  CertOpenSystemStoreA: { parameters: ["usize", "buffer"], result: "pointer" },
});
// lib.symbols.CertOpenSystemStoreA(hProv, szSubsystemProtocol)
// hProv : HCRYPTPROV_LEGACY optional -> "usize"
// szSubsystemProtocol : LPCSTR -> "buffer"
// 文字列は "buffer"。ANSI(-A) は new TextEncoder() で UTF-8/ANSI バイト列(末尾に \x00)を渡す。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
void* CertOpenSystemStoreA(
    size_t hProv,
    const char* szSubsystemProtocol);
C, "CRYPT32.dll");
// $ffi->CertOpenSystemStoreA(hProv, szSubsystemProtocol);
// hProv : HCRYPTPROV_LEGACY optional
// szSubsystemProtocol : LPCSTR
// 構造体/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, W32APIOptions.ASCII_OPTIONS);
    Pointer CertOpenSystemStoreA(
        long hProv,   // HCRYPTPROV_LEGACY optional
        String szSubsystemProtocol   // LPCSTR
    );
}
@[Link("crypt32")]
lib LibCRYPT32
  fun CertOpenSystemStoreA = CertOpenSystemStoreA(
    hProv : LibC::SizeT,   # HCRYPTPROV_LEGACY optional
    szSubsystemProtocol : UInt8*   # LPCSTR
  ) : Void*
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef CertOpenSystemStoreANative = Pointer<Void> Function(UintPtr, Pointer<Utf8>);
typedef CertOpenSystemStoreADart = Pointer<Void> Function(int, Pointer<Utf8>);
final CertOpenSystemStoreA = DynamicLibrary.open('CRYPT32.dll')
    .lookupFunction<CertOpenSystemStoreANative, CertOpenSystemStoreADart>('CertOpenSystemStoreA');
// hProv : HCRYPTPROV_LEGACY optional -> UintPtr
// szSubsystemProtocol : LPCSTR -> Pointer<Utf8>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function CertOpenSystemStoreA(
  hProv: NativeUInt;   // HCRYPTPROV_LEGACY optional
  szSubsystemProtocol: PAnsiChar   // LPCSTR
): THandle; stdcall;
  external 'CRYPT32.dll' name 'CertOpenSystemStoreA';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "CertOpenSystemStoreA"
  c_CertOpenSystemStoreA :: CUIntPtr -> CString -> IO (Ptr ())
-- hProv : HCRYPTPROV_LEGACY optional -> CUIntPtr
-- szSubsystemProtocol : LPCSTR -> CString
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let certopensystemstorea =
  foreign "CertOpenSystemStoreA"
    (size_t @-> string @-> returning (ptr void))
(* hProv : HCRYPTPROV_LEGACY optional -> size_t *)
(* szSubsystemProtocol : LPCSTR -> string *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library crypt32 (t "CRYPT32.dll"))
(cffi:use-foreign-library crypt32)

(cffi:defcfun ("CertOpenSystemStoreA" cert-open-system-store-a :convention :stdcall) :pointer
  (h-prov :uint64)   ; HCRYPTPROV_LEGACY optional
  (sz-subsystem-protocol :string))   ; LPCSTR
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $CertOpenSystemStoreA = Win32::API::More->new('CRYPT32',
    'HANDLE CertOpenSystemStoreA(WPARAM hProv, LPCSTR szSubsystemProtocol)');
# my $ret = $CertOpenSystemStoreA->Call($hProv, $szSubsystemProtocol);
# hProv : HCRYPTPROV_LEGACY optional -> WPARAM
# szSubsystemProtocol : LPCSTR -> LPCSTR
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

関連項目

文字セット違い
公式の関連項目