ホーム › Security.Cryptography › CRYPT_RETRIEVE_AUX_INFO
CRYPT_RETRIEVE_AUX_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | 構造体のサイズ (バイト単位)。 |
| pLastSyncTime | FILETIME* | 8/4 | +8 | +4 | 取得したデータの最終同期時刻を格納する FILETIME 構造体。 |
| dwMaxUrlRetrievalByteCount | DWORD | 4 | +16 | +8 | 取得するバイト数の上限を指定する値。0 以下の値は制限なしを意味します。 |
| pPreFetchInfo | CRYPTNET_URL_CACHE_PRE_FETCH_INFO* | 8/4 | +24 | +12 | CRYPTNET_URL_CACHE_PRE_FETCH_INFO 構造体へのポインター。プリフェッチ情報を取得するには、入力時にその cbSize を設定します。プリフェッチ情報がない場合、このデータ構造は cbSize を除き、戻り時に 0 を格納します。 |
| pFlushInfo | CRYPTNET_URL_CACHE_FLUSH_INFO* | 8/4 | +32 | +16 | CRYPTNET_URL_CACHE_FLUSH_INFO 構造体へのポインター。フラッシュ情報を取得するには、入力時にその cbSize を設定します。フラッシュ情報がない場合、このデータ構造は cbSize を除き、戻り時に 0 を格納します。 |
| ppResponseInfo | CRYPTNET_URL_CACHE_RESPONSE_INFO** | 8/4 | +40 | +20 | PCRYPTNET_URL_CACHE_RESPONSE_INFO 構造体へのポインター。応答情報を取得するには、割り当てられた構造体で更新される CRYPTNET_URL_CACHE_RESPONSE_INFO ポインターのアドレスを、このポインターに設定します。応答情報がない場合、ppResponseInfo には NULL が設定されます。NULL でない場合は、CryptMemFree 関数を使用して解放しなければなりません。 |
| pwszCacheFileNamePrefix | LPWSTR | 8/4 | +48 | +24 | キャッシュされるファイル名の接頭辞を格納する文字列へのポインター。NULL でない場合、指定した接頭辞文字列がキャッシュされるファイル名の先頭に連結されます。 |
| pftCacheResync | FILETIME* | 8/4 | +56 | +28 | キャッシュの同期時刻を指定する FILETIME 構造体へのポインター。NULL でない場合、この時刻より前にキャッシュされた情報は時刻的に無効と見なされます。CRYPT_CACHE_ONLY_RETRIEVAL の場合、この時刻より前のキャッシュエントリが存在すると、CryptRetrieveObjectByUrl は ERROR_INVALID_TIME を返します。HTTP による取得で使用する場合、これは時刻的に有効なオブジェクトの最大有効期間を指定します。 |
| fProxyCacheRetrieval | BOOL | 4 | +64 | +32 | CryptRetrieveObjectByUrl が dwRetrievalFlags に CRYPT_PROXY_CACHE_RETRIEVAL を設定して呼び出され、かつその取得でプロキシキャッシュが明示的にバイパスされなかったかどうかを示す値。このフラグは明示的にクリアされず、HTTP URL の取得にのみ適用されます。 |
| dwHttpStatusCode | DWORD | 4 | +68 | +36 | 失敗した HTTP 応答ヘッダーのステータスコードを指定する値。dwRetrievalFlags に CRYPT_NOT_MODIFIED_RETRIEVAL が設定され、HTTP による取得が HTTP_STATUS_NOT_MODIFIED を返した場合、このメンバーには HTTP_STATUS_NOT_MODIFIED ステータスコードが格納されます。この値は明示的にクリアされず、HTTP または HTTPS の URL 取得の場合にのみ更新されます。 |
| ppwszErrorResponseHeaders | LPWSTR* | 8/4 | +72 | +40 | エラー応答ヘッダ文字列を受け取るポインタのアドレス。NULL可。 |
| ppErrorContentBlob | CRYPT_INTEGER_BLOB** | 8/4 | +80 | +44 | エラー応答本文BLOBを受け取るポインタのアドレス。NULL可。 |
公式ドキュメント
CRYPT_RETRIEVE_AUX_INFO 構造体は、CryptRetrieveObjectByUrl 関数に渡すオプションの情報を格納します。この構造体の未使用のメンバーはすべて 0 でなければなりません。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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>
// CRYPT_RETRIEVE_AUX_INFO (x64 88 / x86 48 バイト)
typedef struct CRYPT_RETRIEVE_AUX_INFO {
DWORD cbSize;
FILETIME* pLastSyncTime;
DWORD dwMaxUrlRetrievalByteCount;
CRYPTNET_URL_CACHE_PRE_FETCH_INFO* pPreFetchInfo;
CRYPTNET_URL_CACHE_FLUSH_INFO* pFlushInfo;
CRYPTNET_URL_CACHE_RESPONSE_INFO** ppResponseInfo;
LPWSTR pwszCacheFileNamePrefix;
FILETIME* pftCacheResync;
BOOL fProxyCacheRetrieval;
DWORD dwHttpStatusCode;
LPWSTR* ppwszErrorResponseHeaders;
CRYPT_INTEGER_BLOB** ppErrorContentBlob;
} CRYPT_RETRIEVE_AUX_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPT_RETRIEVE_AUX_INFO
{
public uint cbSize;
public IntPtr pLastSyncTime;
public uint dwMaxUrlRetrievalByteCount;
public IntPtr pPreFetchInfo;
public IntPtr pFlushInfo;
public IntPtr ppResponseInfo;
public IntPtr pwszCacheFileNamePrefix;
public IntPtr pftCacheResync;
[MarshalAs(UnmanagedType.Bool)] public bool fProxyCacheRetrieval;
public uint dwHttpStatusCode;
public IntPtr ppwszErrorResponseHeaders;
public IntPtr ppErrorContentBlob;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPT_RETRIEVE_AUX_INFO
Public cbSize As UInteger
Public pLastSyncTime As IntPtr
Public dwMaxUrlRetrievalByteCount As UInteger
Public pPreFetchInfo As IntPtr
Public pFlushInfo As IntPtr
Public ppResponseInfo As IntPtr
Public pwszCacheFileNamePrefix As IntPtr
Public pftCacheResync As IntPtr
<MarshalAs(UnmanagedType.Bool)> Public fProxyCacheRetrieval As Boolean
Public dwHttpStatusCode As UInteger
Public ppwszErrorResponseHeaders As IntPtr
Public ppErrorContentBlob As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class CRYPT_RETRIEVE_AUX_INFO(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("pLastSyncTime", ctypes.c_void_p),
("dwMaxUrlRetrievalByteCount", wintypes.DWORD),
("pPreFetchInfo", ctypes.c_void_p),
("pFlushInfo", ctypes.c_void_p),
("ppResponseInfo", ctypes.c_void_p),
("pwszCacheFileNamePrefix", ctypes.c_void_p),
("pftCacheResync", ctypes.c_void_p),
("fProxyCacheRetrieval", wintypes.BOOL),
("dwHttpStatusCode", wintypes.DWORD),
("ppwszErrorResponseHeaders", ctypes.c_void_p),
("ppErrorContentBlob", ctypes.c_void_p),
]#[repr(C)]
pub struct CRYPT_RETRIEVE_AUX_INFO {
pub cbSize: u32,
pub pLastSyncTime: *mut core::ffi::c_void,
pub dwMaxUrlRetrievalByteCount: u32,
pub pPreFetchInfo: *mut core::ffi::c_void,
pub pFlushInfo: *mut core::ffi::c_void,
pub ppResponseInfo: *mut core::ffi::c_void,
pub pwszCacheFileNamePrefix: *mut core::ffi::c_void,
pub pftCacheResync: *mut core::ffi::c_void,
pub fProxyCacheRetrieval: i32,
pub dwHttpStatusCode: u32,
pub ppwszErrorResponseHeaders: *mut core::ffi::c_void,
pub ppErrorContentBlob: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type CRYPT_RETRIEVE_AUX_INFO struct {
cbSize uint32
pLastSyncTime uintptr
dwMaxUrlRetrievalByteCount uint32
pPreFetchInfo uintptr
pFlushInfo uintptr
ppResponseInfo uintptr
pwszCacheFileNamePrefix uintptr
pftCacheResync uintptr
fProxyCacheRetrieval int32
dwHttpStatusCode uint32
ppwszErrorResponseHeaders uintptr
ppErrorContentBlob uintptr
}type
CRYPT_RETRIEVE_AUX_INFO = record
cbSize: DWORD;
pLastSyncTime: Pointer;
dwMaxUrlRetrievalByteCount: DWORD;
pPreFetchInfo: Pointer;
pFlushInfo: Pointer;
ppResponseInfo: Pointer;
pwszCacheFileNamePrefix: Pointer;
pftCacheResync: Pointer;
fProxyCacheRetrieval: BOOL;
dwHttpStatusCode: DWORD;
ppwszErrorResponseHeaders: Pointer;
ppErrorContentBlob: Pointer;
end;const CRYPT_RETRIEVE_AUX_INFO = extern struct {
cbSize: u32,
pLastSyncTime: ?*anyopaque,
dwMaxUrlRetrievalByteCount: u32,
pPreFetchInfo: ?*anyopaque,
pFlushInfo: ?*anyopaque,
ppResponseInfo: ?*anyopaque,
pwszCacheFileNamePrefix: ?*anyopaque,
pftCacheResync: ?*anyopaque,
fProxyCacheRetrieval: i32,
dwHttpStatusCode: u32,
ppwszErrorResponseHeaders: ?*anyopaque,
ppErrorContentBlob: ?*anyopaque,
};type
CRYPT_RETRIEVE_AUX_INFO {.bycopy.} = object
cbSize: uint32
pLastSyncTime: pointer
dwMaxUrlRetrievalByteCount: uint32
pPreFetchInfo: pointer
pFlushInfo: pointer
ppResponseInfo: pointer
pwszCacheFileNamePrefix: pointer
pftCacheResync: pointer
fProxyCacheRetrieval: int32
dwHttpStatusCode: uint32
ppwszErrorResponseHeaders: pointer
ppErrorContentBlob: pointerstruct CRYPT_RETRIEVE_AUX_INFO
{
uint cbSize;
void* pLastSyncTime;
uint dwMaxUrlRetrievalByteCount;
void* pPreFetchInfo;
void* pFlushInfo;
void* ppResponseInfo;
void* pwszCacheFileNamePrefix;
void* pftCacheResync;
int fProxyCacheRetrieval;
uint dwHttpStatusCode;
void* ppwszErrorResponseHeaders;
void* ppErrorContentBlob;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRYPT_RETRIEVE_AUX_INFO サイズ: 48 バイト(x86)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pLastSyncTime : FILETIME* (+4, 4byte) varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; dwMaxUrlRetrievalByteCount : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; pPreFetchInfo : CRYPTNET_URL_CACHE_PRE_FETCH_INFO* (+12, 4byte) varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; pFlushInfo : CRYPTNET_URL_CACHE_FLUSH_INFO* (+16, 4byte) varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; ppResponseInfo : CRYPTNET_URL_CACHE_RESPONSE_INFO** (+20, 4byte) varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; pwszCacheFileNamePrefix : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pftCacheResync : FILETIME* (+28, 4byte) varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; fProxyCacheRetrieval : BOOL (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; dwHttpStatusCode : DWORD (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; ppwszErrorResponseHeaders : LPWSTR* (+40, 4byte) st.10 = 値 / 値 = st.10 (lpoke/lpeek も可)
; ppErrorContentBlob : CRYPT_INTEGER_BLOB** (+44, 4byte) varptr(st)+44 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPT_RETRIEVE_AUX_INFO サイズ: 88 バイト(x64)
dim st, 22 ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pLastSyncTime : FILETIME* (+8, 8byte) varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; dwMaxUrlRetrievalByteCount : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pPreFetchInfo : CRYPTNET_URL_CACHE_PRE_FETCH_INFO* (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; pFlushInfo : CRYPTNET_URL_CACHE_FLUSH_INFO* (+32, 8byte) varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; ppResponseInfo : CRYPTNET_URL_CACHE_RESPONSE_INFO** (+40, 8byte) varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; pwszCacheFileNamePrefix : LPWSTR (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; pftCacheResync : FILETIME* (+56, 8byte) varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; fProxyCacheRetrieval : BOOL (+64, 4byte) st.16 = 値 / 値 = st.16 (lpoke/lpeek も可)
; dwHttpStatusCode : DWORD (+68, 4byte) st.17 = 値 / 値 = st.17 (lpoke/lpeek も可)
; ppwszErrorResponseHeaders : LPWSTR* (+72, 8byte) qpoke st,72,値 / qpeek(st,72) ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; ppErrorContentBlob : CRYPT_INTEGER_BLOB** (+80, 8byte) varptr(st)+80 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CRYPT_RETRIEVE_AUX_INFO
#field int cbSize
#field intptr pLastSyncTime
#field int dwMaxUrlRetrievalByteCount
#field intptr pPreFetchInfo
#field intptr pFlushInfo
#field intptr ppResponseInfo
#field intptr pwszCacheFileNamePrefix
#field intptr pftCacheResync
#field bool fProxyCacheRetrieval
#field int dwHttpStatusCode
#field intptr ppwszErrorResponseHeaders
#field intptr ppErrorContentBlob
#endstruct
stdim st, CRYPT_RETRIEVE_AUX_INFO ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize