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

CERT_STORE_PROV_INFO

構造体
サイズx64: 40 バイト / x86: 24 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズをバイト単位で格納します。
cStoreProvFuncDWORD4+4+4rgpvStoreProvFunc 配列の要素数を格納します。このカウントには、実装されている最後のコールバック関数より前のインデックスで使用される NULL 値もすべて含める必要があります。たとえば、コールバック関数が 1 つだけ実装されていて、それがインデックス 2 (CERT_STORE_PROV_WRITE_CERT_FUNC) にあり、インデックス 0 と 1 が NULL である場合、このパラメーターには 3 を渡す必要があります。
rgpvStoreProvFuncvoid**8/4+8+8

プロバイダーによって実装されているコールバック関数へのポインターの配列です。この配列は次の表に示す値でインデックス付けされ、示されている順序でなければなりません。関連付けられているコールバック関数も併せて示します。実装されていないコールバック関数はすべて NULL に設定しなければなりません。配列にすべてのコールバック関数インデックスを含める必要はなく、実装されている最も大きいコールバック関数インデックスまでを含めれば十分です。たとえば、CERT_STORE_PROV_WRITE_CERT_FUNC (2) コールバック関数のみが実装されている場合、配列に必要な要素は 3 つだけです。

意味
CERT_STORE_PROV_CLOSE_FUNC
0 (0x0)

CertStoreProvCloseCallback

CERT_STORE_PROV_READ_CERT_FUNC
1 (0x1)

CertStoreProvReadCertCallback

CERT_STORE_PROV_WRITE_CERT_FUNC
2 (0x2)

CertStoreProvWriteCertCallback

CERT_STORE_PROV_DELETE_CERT_FUNC
3 (0x3)

CertStoreProvDeleteCertCallback

CERT_STORE_PROV_SET_CERT_PROPERTY_FUNC
4 (0x4)

CertStoreProvSetCertPropertyCallback

CERT_STORE_PROV_READ_CRL_FUNC
5 (0x5)

CertStoreProvReadCRLCallback

CERT_STORE_PROV_WRITE_CRL_FUNC
6 (0x6)

CertStoreProvWriteCRLCallback

CERT_STORE_PROV_DELETE_CRL_FUNC
7 (0x7)

CertStoreProvDeleteCRLCallback

CERT_STORE_PROV_SET_CRL_PROPERTY_FUNC
8 (0x8)

CertStoreProvSetCRLPropertyCallback

CERT_STORE_PROV_READ_CTL_FUNC
9 (0x9)

CertStoreProvReadCTL

CERT_STORE_PROV_WRITE_CTL_FUNC
10 (0xA)

CertStoreProvWriteCTL

CERT_STORE_PROV_DELETE_CTL_FUNC
11 (0xB)

CertStoreProvDeleteCTL

CERT_STORE_PROV_SET_CTL_PROPERTY_FUNC
12 (0xC)

CertStoreProvSetCTLProperty

CERT_STORE_PROV_CONTROL_FUNC
13 (0xD)

CertStoreProvControl

CERT_STORE_PROV_FIND_CERT_FUNC
14 (0xE)

CertStoreProvFindCert

CERT_STORE_PROV_FREE_FIND_CERT_FUNC
15 (0xF)

CertStoreProvFreeFindCert

CERT_STORE_PROV_GET_CERT_PROPERTY_FUNC
16 (0x10)

CertStoreProvGetCertProperty

CERT_STORE_PROV_FIND_CRL_FUNC
17 (0x11)

CertStoreProvFindCRL

CERT_STORE_PROV_FREE_FIND_CRL_FUNC
18 (0x12)

CertStoreProvFreeFindCRL

CERT_STORE_PROV_GET_CRL_PROPERTY_FUNC
19 (0x13)

CertStoreProvGetCRLProperty

CERT_STORE_PROV_FIND_CTL_FUNC
20 (0x14)

CertStoreProvFindCTL

CERT_STORE_PROV_FREE_FIND_CTL_FUNC
21 (0x15)

CertStoreProvFreeFindCTL

CERT_STORE_PROV_GET_CTL_PROPERTY_FUNC
22 (0x16)

CertStoreProvGetCTLProperty

hStoreProvHCERTSTOREPROV8/4+16+12すべてのコールバックに最初のパラメーターとして渡される、アプリケーション定義の 32 ビット値です。アプリケーションはこのメンバーの内容を任意に指定できます。通常は、開かれた各ストアのプロバイダーの状態情報など、アプリケーション固有のデータへのポインターを指定します。
dwStoreProvFlagsCERT_STORE_PROV_FLAGS4+24+16

プロバイダーの動作方法を指定するフラグのセットを格納します。0、または次の値の 1 つ以上の組み合わせを格納します。

意味
CERT_STORE_PROV_EXTERNAL_FLAG
1 (0x1)
プロバイダーは、ストアのキャッシュの外部にある 証明書証明書失効リスト証明書信頼リスト を格納します。
CERT_STORE_PROV_DELETED_FLAG
2 (0x2)
ストアは正常に削除されました。CertStoreProvCloseCallback コールバックは呼び出されません。
CERT_STORE_PROV_NO_PERSIST_FLAG
4 (0x4)
既定では、プロバイダーはストアに対して行われた変更を永続化します。このフラグが設定されている場合、プロバイダーはストアに対して行われた変更を永続化しません。
CERT_STORE_PROV_SYSTEM_STORE_FLAG
8 (0x8)
プロバイダーはコンテキストをシステムストアに永続化します。
CERT_STORE_PROV_LM_SYSTEM_STORE_FLAG
16 (0x10)
プロバイダーはコンテキストを LocalMachine システムストアに永続化します。
hStoreProvFuncAddr2void*8/4+32+20CryptGetOIDFunctionAddress によって返されたハンドルを格納します。 CertCloseStore は、NULL 以外の hStoreProvFuncAddr2 を解放するために CryptFreeOIDFunctionAddress を呼び出します。これにより、コールバックは、ストアが閉じられるときに解放されるもう 1 つのインストール可能な関数を呼び出すことができます。

公式ドキュメント

CERT_STORE_PROV_INFO 構造体には、 CertOpenStore 関数を使用してストアを開いたときに、インストールされている CertDllOpenStoreProv 関数から返される情報が格納されます。

ストアを開くとき、CertOpenStore 関数は、CERT_STORE_PROV_INFO のサイズが設定される cbSize を除き、CERT_STORE_PROV_INFO 構造体のすべてのフィールドを 0 に設定します。この構造体は、インストール可能な関数 CertDllOpenStoreProv によって更新されます。呼び出す追加のコールバック関数がない場合、cStoreProvFunc は戻り時も 0 のままになります。

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

各言語での定義

#include <windows.h>

// CERT_STORE_PROV_INFO  (x64 40 / x86 24 バイト)
typedef struct CERT_STORE_PROV_INFO {
    DWORD cbSize;
    DWORD cStoreProvFunc;
    void** rgpvStoreProvFunc;
    HCERTSTOREPROV hStoreProv;
    CERT_STORE_PROV_FLAGS dwStoreProvFlags;
    void* hStoreProvFuncAddr2;
} CERT_STORE_PROV_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CERT_STORE_PROV_INFO
{
    public uint cbSize;
    public uint cStoreProvFunc;
    public IntPtr rgpvStoreProvFunc;
    public IntPtr hStoreProv;
    public uint dwStoreProvFlags;
    public IntPtr hStoreProvFuncAddr2;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CERT_STORE_PROV_INFO
    Public cbSize As UInteger
    Public cStoreProvFunc As UInteger
    Public rgpvStoreProvFunc As IntPtr
    Public hStoreProv As IntPtr
    Public dwStoreProvFlags As UInteger
    Public hStoreProvFuncAddr2 As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class CERT_STORE_PROV_INFO(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("cStoreProvFunc", wintypes.DWORD),
        ("rgpvStoreProvFunc", ctypes.c_void_p),
        ("hStoreProv", ctypes.c_void_p),
        ("dwStoreProvFlags", wintypes.DWORD),
        ("hStoreProvFuncAddr2", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct CERT_STORE_PROV_INFO {
    pub cbSize: u32,
    pub cStoreProvFunc: u32,
    pub rgpvStoreProvFunc: *mut core::ffi::c_void,
    pub hStoreProv: *mut core::ffi::c_void,
    pub dwStoreProvFlags: u32,
    pub hStoreProvFuncAddr2: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type CERT_STORE_PROV_INFO struct {
	cbSize uint32
	cStoreProvFunc uint32
	rgpvStoreProvFunc uintptr
	hStoreProv uintptr
	dwStoreProvFlags uint32
	hStoreProvFuncAddr2 uintptr
}
type
  CERT_STORE_PROV_INFO = record
    cbSize: DWORD;
    cStoreProvFunc: DWORD;
    rgpvStoreProvFunc: Pointer;
    hStoreProv: Pointer;
    dwStoreProvFlags: DWORD;
    hStoreProvFuncAddr2: Pointer;
  end;
const CERT_STORE_PROV_INFO = extern struct {
    cbSize: u32,
    cStoreProvFunc: u32,
    rgpvStoreProvFunc: ?*anyopaque,
    hStoreProv: ?*anyopaque,
    dwStoreProvFlags: u32,
    hStoreProvFuncAddr2: ?*anyopaque,
};
type
  CERT_STORE_PROV_INFO {.bycopy.} = object
    cbSize: uint32
    cStoreProvFunc: uint32
    rgpvStoreProvFunc: pointer
    hStoreProv: pointer
    dwStoreProvFlags: uint32
    hStoreProvFuncAddr2: pointer
struct CERT_STORE_PROV_INFO
{
    uint cbSize;
    uint cStoreProvFunc;
    void* rgpvStoreProvFunc;
    void* hStoreProv;
    uint dwStoreProvFlags;
    void* hStoreProvFuncAddr2;
}

HSP用 定義

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

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

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