CRYPTNET_URL_CACHE_PRE_FETCH_INFO-Struktur (wincrypt.h)

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