Share via

CRYPTNET_URL_CACHE_PRE_FETCH_INFO-Struktur (wincrypt.h)

  • Artikel

Die CRYPTNET_URL_CACHE_PRE_FETCH_INFO-Struktur enthält Updateinformationen, die vom CUC-Dienst (Cryptnet URL Cache) zum Verwalten eines URL-Cacheeintrags verwendet werden. Diese Struktur besteht aus dem pPreFetchInfo-Member der CRYPT_RETRIEVE_AUX_INFO-Struktur, die als pAuxInfo-Parameter an die CryptRetrieveObjectByUrl-Funktion übergeben wird.

Syntax

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;

Member

cbSize

Die Größe (in Bytes) dieser Struktur.

dwObjectType

Ein Wert, der den Typ des von der URL dargestellten Objekts angibt.

Wert Bedeutung
CRYPTNET_URL_CACHE_PRE_FETCH_NONE
0
 Vorabstartinformationen sind noch nicht vorhanden.
CRYPTNET_URL_CACHE_PRE_FETCH_BLOB
1
 Das Objekt ist ein Speicherblob.
CRYPTNET_URL_CACHE_PRE_FETCH_CRL
2
 Das Objekt ist eine Zertifikatsperrliste (Certificate Revocation List , CRL).
CRYPTNET_URL_CACHE_PRE_FETCH_OCSP
3
 Das Objekt ist ein Onlinezertifikat status Protokollantwort (OCSP).
CRYPTNET_URL_CACHE_PRE_FETCH_AUTOROOT_CAB
5
 Das Objekt ist eine CAB-Datei.

dwError

Ein Wert, der die status eines Vorabstartversuchs angibt.

Wert Bedeutung
S_OK
0x00000000L
 Der Prefetch steht aus.
ERROR_MEDIA_OFFLINE
4304L
 Der CRL-Prefetch ist deaktiviert, da der OCSP-Dienst offline oder nicht verfügbar ist.
ERROR_FILE_OFFLINE
4350L
 Der Prefetchinhalt bleibt unverändert.
ERROR_INVALID_DATA
13L
 Der Vorabstartinhalt ist ungültig.
Andere Werte
 Der Dienst kann keine vorab abgerufenen Inhalte abrufen.

dwReserved

Dieser Parameter wird nicht verwendet. Sie muss null sein.

ThisUpdateTime

Eine FILETIME-Struktur , die ein Datum und eine Uhrzeit enthält, deren Bedeutung von dwObjectType abhängt. Bei einer Zertifikatsperrliste gibt dies an, wann die Zertifikatsperrliste veröffentlicht wurde. Bei einer OCSP-Antwort gibt dies an, wenn die angegebene status bekannt ist, dass sie richtig ist.

NextUpdateTime

Eine FILETIME-Struktur , die ein Datum und eine Uhrzeit enthält, deren Bedeutung von dwObjectType abhängt. Bei einer Zertifikatsperrliste gibt dies das nächste geplante Update für die Zertifikatsperrliste an. Bei einer OCSP-Antwort gibt dies an, wann neuere Informationen für das Zertifikat status verfügbar sind.

Dies ist effektiv ein Ablaufdatum für das Objekt. Der Wert 0 gibt an, dass die Informationen kein Ablaufdatum haben.

PublishTime

Eine FILETIME-Struktur , die das Zeitintervall vor Ablauf angibt, in dem eine neue Zertifikatsperrliste veröffentlicht wird. Dieser Wert kann auch 0 sein.

Dieser Wert basiert auf einer nicht standardmäßigen CRL-Erweiterung mit dem folgenden Objektbezeichner (Object Identifier, OID).

Wert Bedeutung
szOID_CRL_NEXT_PUBLISH
1.3.6.1.4.1.311.21.4
 NextPublishTime

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile wincrypt.h