ホーム › Security.Cryptography.Catalog › CRYPTCATCDF
CRYPTCATCDF
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbStruct | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。 |
| hFile | HANDLE | 8/4 | +8 | +4 | カタログ定義ファイル (.cdf) へのハンドル。 |
| dwCurFilePos | DWORD | 4 | +16 | +8 | カタログ定義ファイルの先頭からのバイト単位で測った、パーサーの現在位置を指定する値。 |
| dwLastMemberOffset | DWORD | 4 | +20 | +12 | カタログ定義ファイル内で最後に解析されたメンバーの位置までのバイト数を指定する値。 |
| fEOF | BOOL | 4 | +24 | +16 | パーサーがファイルの読み取りを完了したかどうかを示す整数。TRUE は、最後の読み取り操作が 0 バイトを返したことを示します。 |
| pwszResultDir | LPWSTR | 8/4 | +32 | +20 | カタログファイル (.cat) が書き込まれるディレクトリの名前を格納する、NULL で終わる文字列へのポインター。 |
| hCATStore | HANDLE | 8/4 | +40 | +24 | カタログファイル (.cat) へのハンドル。 |
公式ドキュメント
[CRYPTCATCDF 構造体は、要件セクションに示されたオペレーティングシステムで使用できます。以降のバージョンでは変更されるか、使用できなくなる可能性があります。]
CRYPTCATCDF 構造体は、カタログ定義ファイル (CDF) から署名済みカタログファイル (.cat) を作成するために使用される情報を格納します。この構造体は MakeCat ツールで使用されます。
解説(Remarks)
パーサーは、CDF を読み取りながら dwCurFilePos と dwLastMemberOffset を更新できます。ユーザー定義のコールバック関数は、CDF 内の回復可能な解析エラーに対してこの情報を利用できます。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CRYPTCATCDF (x64 48 / x86 28 バイト)
typedef struct CRYPTCATCDF {
DWORD cbStruct;
HANDLE hFile;
DWORD dwCurFilePos;
DWORD dwLastMemberOffset;
BOOL fEOF;
LPWSTR pwszResultDir;
HANDLE hCATStore;
} CRYPTCATCDF;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPTCATCDF
{
public uint cbStruct;
public IntPtr hFile;
public uint dwCurFilePos;
public uint dwLastMemberOffset;
[MarshalAs(UnmanagedType.Bool)] public bool fEOF;
public IntPtr pwszResultDir;
public IntPtr hCATStore;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPTCATCDF
Public cbStruct As UInteger
Public hFile As IntPtr
Public dwCurFilePos As UInteger
Public dwLastMemberOffset As UInteger
<MarshalAs(UnmanagedType.Bool)> Public fEOF As Boolean
Public pwszResultDir As IntPtr
Public hCATStore As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class CRYPTCATCDF(ctypes.Structure):
_fields_ = [
("cbStruct", wintypes.DWORD),
("hFile", ctypes.c_void_p),
("dwCurFilePos", wintypes.DWORD),
("dwLastMemberOffset", wintypes.DWORD),
("fEOF", wintypes.BOOL),
("pwszResultDir", ctypes.c_void_p),
("hCATStore", ctypes.c_void_p),
]#[repr(C)]
pub struct CRYPTCATCDF {
pub cbStruct: u32,
pub hFile: *mut core::ffi::c_void,
pub dwCurFilePos: u32,
pub dwLastMemberOffset: u32,
pub fEOF: i32,
pub pwszResultDir: *mut core::ffi::c_void,
pub hCATStore: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type CRYPTCATCDF struct {
cbStruct uint32
hFile uintptr
dwCurFilePos uint32
dwLastMemberOffset uint32
fEOF int32
pwszResultDir uintptr
hCATStore uintptr
}type
CRYPTCATCDF = record
cbStruct: DWORD;
hFile: Pointer;
dwCurFilePos: DWORD;
dwLastMemberOffset: DWORD;
fEOF: BOOL;
pwszResultDir: Pointer;
hCATStore: Pointer;
end;const CRYPTCATCDF = extern struct {
cbStruct: u32,
hFile: ?*anyopaque,
dwCurFilePos: u32,
dwLastMemberOffset: u32,
fEOF: i32,
pwszResultDir: ?*anyopaque,
hCATStore: ?*anyopaque,
};type
CRYPTCATCDF {.bycopy.} = object
cbStruct: uint32
hFile: pointer
dwCurFilePos: uint32
dwLastMemberOffset: uint32
fEOF: int32
pwszResultDir: pointer
hCATStore: pointerstruct CRYPTCATCDF
{
uint cbStruct;
void* hFile;
uint dwCurFilePos;
uint dwLastMemberOffset;
int fEOF;
void* pwszResultDir;
void* hCATStore;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPTCATCDF サイズ: 28 バイト(x86)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hFile : HANDLE (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwCurFilePos : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwLastMemberOffset : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; fEOF : BOOL (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pwszResultDir : LPWSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; hCATStore : HANDLE (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPTCATCDF サイズ: 48 バイト(x64)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hFile : HANDLE (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; dwCurFilePos : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwLastMemberOffset : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; fEOF : BOOL (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pwszResultDir : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; hCATStore : HANDLE (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPTCATCDF
#field int cbStruct
#field intptr hFile
#field int dwCurFilePos
#field int dwLastMemberOffset
#field bool fEOF
#field intptr pwszResultDir
#field intptr hCATStore
#endstruct
stdim st, CRYPTCATCDF ; NSTRUCT 変数を確保
st->cbStruct = 100
mes "cbStruct=" + st->cbStruct