Share via

CRYPTNET_URL_CACHE_PRE_FETCH_INFO 構造体 (wincrypt.h)

  • [アーティクル]

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

構文

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, *PCRYPTNET_URL_CACHE_PRE_FETCH_INFO;

メンバー

cbSize

この構造体のサイズ (バイト単位)。

dwObjectType

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 ファイルです。

dwError

プリフェッチ試行の状態を示す 値。

値 意味
S_OK
0x00000000L
 プリフェッチは保留中です。
ERROR_MEDIA_OFFLINE
4304L
 OCSP サービスがオフラインであるか使用できないため、CRL プリフェッチは無効になっています。
ERROR_FILE_OFFLINE
4350L
 プリフェッチの内容は変更されません。
ERROR_INVALID_DATA
13L
 プリフェッチ コンテンツが無効です。
その他の値
 サービスはプリフェッチ コンテンツを取得できません。

dwReserved

このパラメーターは使用されません。 0 にする必要があります。

ThisUpdateTime

意味が dwObjectType に依存する日付と時刻を含む FILETIME 構造体。 CRL の場合、CRL が発行された日時を示します。 OCSP 応答の場合、これは、示された状態が正しいことがわかっている場合を示します。

NextUpdateTime

意味が dwObjectType に依存する日付と時刻を含む FILETIME 構造体。 CRL の場合、これは CRL の次のスケジュールされた更新を示します。 OCSP 応答の場合、これは、証明書の状態に対して新しい情報が使用できるようになるタイミングを示します。

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

PublishTime

新しい CRL が発行される有効期限までの時間間隔を指定する FILETIME 構造体。 この値はゼロの場合があります。

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

値 意味
szOID_CRL_NEXT_PUBLISH
1.3.6.1.4.1.311.21.4
 NextPublishTime

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header wincrypt.h