CRYPT_RETRIEVE_AUX_INFO-Struktur (wincrypt.h)

Die CRYPT_RETRIEVE_AUX_INFO-Struktur enthält optionale Informationen, die an die CryptRetrieveObjectByUrl-Funktion übergeben werden sollen. Alle nicht verwendeten Member dieser Struktur müssen null enthalten.

Syntax

typedef struct _CRYPT_RETRIEVE_AUX_INFO {
  DWORD                              cbSize;
  FILETIME                           *pLastSyncTime;
  DWORD                              dwMaxUrlRetrievalByteCount;
  PCRYPTNET_URL_CACHE_PRE_FETCH_INFO pPreFetchInfo;
  PCRYPTNET_URL_CACHE_FLUSH_INFO     pFlushInfo;
  PCRYPTNET_URL_CACHE_RESPONSE_INFO  *ppResponseInfo;
  LPWSTR                             pwszCacheFileNamePrefix;
  LPFILETIME                         pftCacheResync;
  BOOL                               fProxyCacheRetrieval;
  DWORD                              dwHttpStatusCode;
  LPWSTR                             *ppwszErrorResponseHeaders;
  PCRYPT_DATA_BLOB                   *ppErrorContentBlob;
} CRYPT_RETRIEVE_AUX_INFO, *PCRYPT_RETRIEVE_AUX_INFO;

Member

cbSize

Die Größe der Struktur in Byte.

pLastSyncTime

Eine FILETIME-Struktur , die den Zeitpunkt der letzten Synchronisierung der abgerufenen Daten enthält.

dwMaxUrlRetrievalByteCount

Ein -Wert, der einen Grenzwert für die Anzahl der abgerufenen Bytes angibt. Ein Wert von 0 oder weniger gibt keinen Grenzwert an.

pPreFetchInfo

Ein Zeiger auf eine CRYPTNET_URL_CACHE_PRE_FETCH_INFO-Struktur . Um Vorabrufinformationen zu erhalten, legen Sie dessen cbSize bei der Eingabe fest. Für keine Vorabrufinformationen mit Ausnahme von cbSize enthält die Datenstruktur bei der Rückgabe null.

pFlushInfo

Ein Zeiger auf eine CRYPTNET_URL_CACHE_FLUSH_INFO-Struktur . Um Leerungsinformationen zu erhalten, legen Sie dessen cbSize bei der Eingabe fest. Für keine Leerungsinformationen mit Ausnahme von cbSize enthält die Datenstruktur bei der Rückgabe null.

ppResponseInfo

Ein Zeiger auf eine PCRYPTNET_URL_CACHE_RESPONSE_INFO-Struktur . Um Antwortinformationen abzurufen, legen Sie den Zeiger auf die Adresse eines CRYPTNET_URL_CACHE_RESPONSE_INFO Zeiger fest, der mit der zugeordneten Struktur aktualisiert wird. Für keine Antwortinformationen ist ppResponseInfo auf NULL festgelegt. Wenn es nicht NULL ist, muss er mithilfe der CryptMemFree-Funktion freigegeben werden.

pwszCacheFileNamePrefix

Ein Zeiger auf eine Zeichenfolge, die ein Präfix für einen zwischengespeicherten Dateinamen enthält. Wenn nicht NULL, wird die angegebene Präfixzeichenfolge mit der Vorderseite des zwischengespeicherten Dateinamens verkettet.

pftCacheResync

Ein Zeiger auf eine FILETIME-Struktur , die eine Cachesynchronisierungszeit angibt. Wenn nicht NULL, werden alle Vor diesem Zeitpunkt zwischengespeicherten Informationen als ungültig betrachtet. Wenn bei einem CRYPT_CACHE_ONLY_RETRIEVAL vor diesem Zeitpunkt ein zwischengespeicherter Eintrag vorhanden ist, gibt CryptRetrieveObjectByUrlERROR_INVALID_TIME zurück. Bei Verwendung mit einem HTTP-Abruf gibt dies das maximale Alter für ein zeit gültiges Objekt an.

fProxyCacheRetrieval

Ein -Wert, der angibt, ob CryptRetrieveObjectByUrl aufgerufen wurde, wobei CRYPT_PROXY_CACHE_RETRIEVAL in dwRetrievalFlags festgelegt wurde und ein Proxycache für den Abruf nicht explizit umgangen wurde. Dieses Flag wird nicht explizit gelöscht und gilt nur für HTTP-URL-Abrufe.

dwHttpStatusCode

Ein -Wert, der einen status Code aus einem nicht erfolgreichen HTTP-Antwortheader angibt. Wenn CRYPT_NOT_MODIFIED_RETRIEVAL in dwRetrievalFlags festgelegt wurde und der HTTP-Abruf HTTP_STATUS_NOT_MODIFIED zurückgibt, enthält dies den HTTP_STATUS_NOT_MODIFIED status Code. Dieser Wert wird nicht explizit gelöscht und nur für HTTP- oder HTTPS-URL-Abrufe aktualisiert.

ppwszErrorResponseHeaders

ppErrorContentBlob

Anforderungen

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