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

CRYPTNET_URL_CACHE_PRE_FETCH_INFO

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 40 バイト / x86: 40 バイト

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

フィールド

フィールド型サイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ (バイト単位)。
dwObjectTypeDWORD4+4+4

URL が表すオブジェクトの種類を指定する値です。

値 意味
CRYPTNET_URL_CACHE_PRE_FETCH_NONE
0
 プリフェッチ情報はまだ存在しません。
CRYPTNET_URL_CACHE_PRE_FETCH_BLOB
1
 オブジェクトはメモリ内の BLOB です。
CRYPTNET_URL_CACHE_PRE_FETCH_CRL
2
 オブジェクトは証明書失効リスト (CRL) です。
CRYPTNET_URL_CACHE_PRE_FETCH_OCSP
3
 オブジェクトはオンライン証明書状態プロトコル (OCSP) の応答です。
CRYPTNET_URL_CACHE_PRE_FETCH_AUTOROOT_CAB
5
 オブジェクトは CAB ファイルです。
dwErrorDWORD4+8+8

プリフェッチ試行の状態を指定する値です。

値 意味
S_OK
0x00000000L
 プリフェッチは保留中です。
ERROR_MEDIA_OFFLINE
4304L
 OCSP サービスがオフラインであるか利用できないため、CRL のプリフェッチは無効になっています。
ERROR_FILE_OFFLINE
4350L
 プリフェッチの内容は変更されていません。
ERROR_INVALID_DATA
13L
 プリフェッチの内容が有効ではありません。
その他の値
 サービスはプリフェッチの内容を取得できません。
dwReservedDWORD4+12+12このパラメーターは使用されません。0 でなければなりません。
ThisUpdateTimeFILETIME8+16+16日付と時刻を格納する FILETIME 構造体で、その意味は dwObjectType によって異なります。CRL の場合は、その CRL が発行された日時を示します。OCSP 応答の場合は、示された状態が正しいと判明している日時を示します。
NextUpdateTimeFILETIME8+24+24

日付と時刻を格納する FILETIME 構造体で、その意味は dwObjectType によって異なります。CRL の場合は、その CRL の次回の更新予定を示します。OCSP 応答の場合は、証明書の状態に関するより新しい情報が利用可能になる日時を示します。

これは実質的にオブジェクトの有効期限です。値が 0 の場合、その情報に有効期限がないことを示します。

PublishTimeFILETIME8+32+32

有効期限が切れる前に新しい CRL が発行されるまでの時間間隔を指定する FILETIME 構造体です。この値は 0 になることがあります。

この値は、次のオブジェクト識別子 (OID) を持つ非標準の CRL 拡張に基づいています。

値 意味
szOID_CRL_NEXT_PUBLISH
1.3.6.1.4.1.311.21.4
 NextPublishTime

公式ドキュメント

CRYPTNET_URL_CACHE_PRE_FETCH_INFO 構造体は、Cryptnet URL Cache (CUC) サービスが URL キャッシュエントリを維持するために使用する更新情報を格納します。この構造体は CRYPT_RETRIEVE_AUX_INFO 構造体の pPreFetchInfo メンバーを構成し、その構造体は CryptRetrieveObjectByUrl 関数に pAuxInfo パラメーターとして渡されます。

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

各言語での定義

#include <windows.h>

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// CRYPTNET_URL_CACHE_PRE_FETCH_INFO  (x64 40 / x86 40 バイト)
typedef struct CRYPTNET_URL_CACHE_PRE_FETCH_INFO {
    DWORD cbSize;
    DWORD dwObjectType;
    DWORD dwError;
    DWORD dwReserved;
    FILETIME ThisUpdateTime;
    FILETIME NextUpdateTime;
    FILETIME PublishTime;
} CRYPTNET_URL_CACHE_PRE_FETCH_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRYPTNET_URL_CACHE_PRE_FETCH_INFO
{
    public uint cbSize;
    public uint dwObjectType;
    public uint dwError;
    public uint dwReserved;
    public FILETIME ThisUpdateTime;
    public FILETIME NextUpdateTime;
    public FILETIME PublishTime;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRYPTNET_URL_CACHE_PRE_FETCH_INFO
    Public cbSize As UInteger
    Public dwObjectType As UInteger
    Public dwError As UInteger
    Public dwReserved As UInteger
    Public ThisUpdateTime As FILETIME
    Public NextUpdateTime As FILETIME
    Public PublishTime As FILETIME
End Structure
import ctypes
from ctypes import wintypes

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class CRYPTNET_URL_CACHE_PRE_FETCH_INFO(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("dwObjectType", wintypes.DWORD),
        ("dwError", wintypes.DWORD),
        ("dwReserved", wintypes.DWORD),
        ("ThisUpdateTime", FILETIME),
        ("NextUpdateTime", FILETIME),
        ("PublishTime", FILETIME),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct CRYPTNET_URL_CACHE_PRE_FETCH_INFO {
    pub cbSize: u32,
    pub dwObjectType: u32,
    pub dwError: u32,
    pub dwReserved: u32,
    pub ThisUpdateTime: FILETIME,
    pub NextUpdateTime: FILETIME,
    pub PublishTime: FILETIME,
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type CRYPTNET_URL_CACHE_PRE_FETCH_INFO struct {
	cbSize uint32
	dwObjectType uint32
	dwError uint32
	dwReserved uint32
	ThisUpdateTime FILETIME
	NextUpdateTime FILETIME
	PublishTime FILETIME
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  CRYPTNET_URL_CACHE_PRE_FETCH_INFO = record
    cbSize: DWORD;
    dwObjectType: DWORD;
    dwError: DWORD;
    dwReserved: DWORD;
    ThisUpdateTime: FILETIME;
    NextUpdateTime: FILETIME;
    PublishTime: FILETIME;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const CRYPTNET_URL_CACHE_PRE_FETCH_INFO = extern struct {
    cbSize: u32,
    dwObjectType: u32,
    dwError: u32,
    dwReserved: u32,
    ThisUpdateTime: FILETIME,
    NextUpdateTime: FILETIME,
    PublishTime: FILETIME,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  CRYPTNET_URL_CACHE_PRE_FETCH_INFO {.bycopy.} = object
    cbSize: uint32
    dwObjectType: uint32
    dwError: uint32
    dwReserved: uint32
    ThisUpdateTime: FILETIME
    NextUpdateTime: FILETIME
    PublishTime: FILETIME
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct CRYPTNET_URL_CACHE_PRE_FETCH_INFO
{
    uint cbSize;
    uint dwObjectType;
    uint dwError;
    uint dwReserved;
    FILETIME ThisUpdateTime;
    FILETIME NextUpdateTime;
    FILETIME PublishTime;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRYPTNET_URL_CACHE_PRE_FETCH_INFO サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwObjectType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwError : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwReserved : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ThisUpdateTime : FILETIME (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; NextUpdateTime : FILETIME (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; PublishTime : FILETIME (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global CRYPTNET_URL_CACHE_PRE_FETCH_INFO
    #field int cbSize
    #field int dwObjectType
    #field int dwError
    #field int dwReserved
    #field FILETIME ThisUpdateTime
    #field FILETIME NextUpdateTime
    #field FILETIME PublishTime
#endstruct

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