CERT_PHYSICAL_STORE_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 | ||||||||||||
| pszOpenStoreProvider | LPSTR | 8/4 | +8 | +4 | 証明書ストアプロバイダーの種類を示す文字列へのポインター。この文字列は CertOpenStore へのシステム呼び出しで渡され、開く証明書ストアのプロバイダーの種類を決定します。定義済みの証明書ストアの種類の名前については、 CertOpenStore を参照してください。 定義済みの証明書ストアプロバイダーの種類に加えて、新しいストアプロバイダーの種類を CryptInstallOIDFunctionAddress または CryptRegisterOIDFunction でインストールして登録できます。詳細については、 CertOpenStore を参照してください。 | ||||||||||||
| dwOpenEncodingType | DWORD | 4 | +16 | +8 | このメンバーは、lpszStoreProvider に CERT_STORE_PROV_MSG、CERT_STORE_PROV_PKCS7、または CERT_STORE_PROV_FILENAME が渡された場合にのみ適用されます。それ以外の場合、このメンバーは使用されません。 次の例のように、証明書とメッセージのエンコードの種類をビット単位の OR 演算で組み合わせて両方を指定することは、常に許容されます。 X509_ASN_ENCODING | PKCS_7_ASN_ENCODING 現在定義されているエンコードの種類は次のとおりです。 | ||||||||||||
| dwOpenFlags | DWORD | 4 | +20 | +12 | システムストアが SERVICES または USERS のストアの場所で開かれる場合、dwOpenFlags のストアの場所は CERT_SYSTEM_STORE_USERS または CERT_SYSTEM_STORE_SERVICES に設定されます。 | ||||||||||||
| OpenParameters | CRYPT_INTEGER_BLOB | 16/8 | +24 | +16 | CertOpenStore 関数の pvPara パラメーターに渡すデータを格納する CRYPT_DATA_BLOB。データ型は指定されたプロバイダーによって異なります。渡す型と内容の詳細については、 CertOpenStore の利用可能なプロバイダーの説明を参照してください。 | ||||||||||||
| dwFlags | DWORD | 4 | +40 | +24 | CERT_PHYSICAL_STORE_INFO に対して、次の dwFlags の値が定義されています。
| ||||||||||||
| dwPriority | DWORD | 4 | +44 | +28 | システムストアが開かれると、その物理ストアは dwPriority の設定に従って順序付けられます。dwPriority の値が大きいほど優先度が高くなります。dwPriority メンバーは CertAddStoreToCollection に渡されます。 |
公式ドキュメント
CERT_PHYSICAL_STORE_INFO 構造体は、物理証明書ストアに関する情報を格納します。これらの構造体の一部のメンバーは、物理ストアを開くために CertOpenStore のシステム呼び出しへ直接渡されます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CRYPT_INTEGER_BLOB (x64 16 / x86 8 バイト)
typedef struct CRYPT_INTEGER_BLOB {
DWORD cbData;
BYTE* pbData;
} CRYPT_INTEGER_BLOB;
// CERT_PHYSICAL_STORE_INFO (x64 48 / x86 32 バイト)
typedef struct CERT_PHYSICAL_STORE_INFO {
DWORD cbSize;
LPSTR pszOpenStoreProvider;
DWORD dwOpenEncodingType;
DWORD dwOpenFlags;
CRYPT_INTEGER_BLOB OpenParameters;
DWORD dwFlags;
DWORD dwPriority;
} CERT_PHYSICAL_STORE_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_INTEGER_BLOB
{
public uint cbData;
public IntPtr pbData;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CERT_PHYSICAL_STORE_INFO
{
public uint cbSize;
public IntPtr pszOpenStoreProvider;
public uint dwOpenEncodingType;
public uint dwOpenFlags;
public CRYPT_INTEGER_BLOB OpenParameters;
public uint dwFlags;
public uint dwPriority;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPT_INTEGER_BLOB
Public cbData As UInteger
Public pbData As IntPtr
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CERT_PHYSICAL_STORE_INFO
Public cbSize As UInteger
Public pszOpenStoreProvider As IntPtr
Public dwOpenEncodingType As UInteger
Public dwOpenFlags As UInteger
Public OpenParameters As CRYPT_INTEGER_BLOB
Public dwFlags As UInteger
Public dwPriority As UInteger
End Structureimport ctypes
from ctypes import wintypes
class CRYPT_INTEGER_BLOB(ctypes.Structure):
_fields_ = [
("cbData", wintypes.DWORD),
("pbData", ctypes.c_void_p),
]
class CERT_PHYSICAL_STORE_INFO(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("pszOpenStoreProvider", ctypes.c_void_p),
("dwOpenEncodingType", wintypes.DWORD),
("dwOpenFlags", wintypes.DWORD),
("OpenParameters", CRYPT_INTEGER_BLOB),
("dwFlags", wintypes.DWORD),
("dwPriority", wintypes.DWORD),
]#[repr(C)]
pub struct CRYPT_INTEGER_BLOB {
pub cbData: u32,
pub pbData: *mut core::ffi::c_void,
}
#[repr(C)]
pub struct CERT_PHYSICAL_STORE_INFO {
pub cbSize: u32,
pub pszOpenStoreProvider: *mut core::ffi::c_void,
pub dwOpenEncodingType: u32,
pub dwOpenFlags: u32,
pub OpenParameters: CRYPT_INTEGER_BLOB,
pub dwFlags: u32,
pub dwPriority: u32,
}import "golang.org/x/sys/windows"
type CRYPT_INTEGER_BLOB struct {
cbData uint32
pbData uintptr
}
type CERT_PHYSICAL_STORE_INFO struct {
cbSize uint32
pszOpenStoreProvider uintptr
dwOpenEncodingType uint32
dwOpenFlags uint32
OpenParameters CRYPT_INTEGER_BLOB
dwFlags uint32
dwPriority uint32
}type
CRYPT_INTEGER_BLOB = record
cbData: DWORD;
pbData: Pointer;
end;
CERT_PHYSICAL_STORE_INFO = record
cbSize: DWORD;
pszOpenStoreProvider: Pointer;
dwOpenEncodingType: DWORD;
dwOpenFlags: DWORD;
OpenParameters: CRYPT_INTEGER_BLOB;
dwFlags: DWORD;
dwPriority: DWORD;
end;const CRYPT_INTEGER_BLOB = extern struct {
cbData: u32,
pbData: ?*anyopaque,
};
const CERT_PHYSICAL_STORE_INFO = extern struct {
cbSize: u32,
pszOpenStoreProvider: ?*anyopaque,
dwOpenEncodingType: u32,
dwOpenFlags: u32,
OpenParameters: CRYPT_INTEGER_BLOB,
dwFlags: u32,
dwPriority: u32,
};type
CRYPT_INTEGER_BLOB {.bycopy.} = object
cbData: uint32
pbData: pointer
CERT_PHYSICAL_STORE_INFO {.bycopy.} = object
cbSize: uint32
pszOpenStoreProvider: pointer
dwOpenEncodingType: uint32
dwOpenFlags: uint32
OpenParameters: CRYPT_INTEGER_BLOB
dwFlags: uint32
dwPriority: uint32struct CRYPT_INTEGER_BLOB
{
uint cbData;
void* pbData;
}
struct CERT_PHYSICAL_STORE_INFO
{
uint cbSize;
void* pszOpenStoreProvider;
uint dwOpenEncodingType;
uint dwOpenFlags;
CRYPT_INTEGER_BLOB OpenParameters;
uint dwFlags;
uint dwPriority;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CERT_PHYSICAL_STORE_INFO サイズ: 32 バイト(x86)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pszOpenStoreProvider : LPSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwOpenEncodingType : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwOpenFlags : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; OpenParameters : CRYPT_INTEGER_BLOB (+16, 8byte) varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; dwFlags : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; dwPriority : DWORD (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CERT_PHYSICAL_STORE_INFO サイズ: 48 バイト(x64)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pszOpenStoreProvider : LPSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; dwOpenEncodingType : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwOpenFlags : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; OpenParameters : CRYPT_INTEGER_BLOB (+24, 16byte) varptr(st)+24 を基点に操作(16byte:入れ子/配列)
; dwFlags : DWORD (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; dwPriority : DWORD (+44, 4byte) st.11 = 値 / 値 = st.11 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global CRYPT_INTEGER_BLOB
#field int cbData
#field intptr pbData
#endstruct
#defstruct global CERT_PHYSICAL_STORE_INFO
#field int cbSize
#field intptr pszOpenStoreProvider
#field int dwOpenEncodingType
#field int dwOpenFlags
#field CRYPT_INTEGER_BLOB OpenParameters
#field int dwFlags
#field int dwPriority
#endstruct
stdim st, CERT_PHYSICAL_STORE_INFO ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize