struttura CRYPT_RETRIEVE_AUX_INFO (wincrypt.h)

La struttura CRYPT_RETRIEVE_AUX_INFO contiene informazioni facoltative da passare alla funzione CryptRetrieveObjectByUrl . Tutti i membri inutilizzati di questa struttura devono contenere zero.

Sintassi

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;

Members

cbSize

Dimensione, in byte, della struttura.

pLastSyncTime

Struttura FILETIME che contiene l'ora dell'ultima sincronizzazione dei dati recuperati.

dwMaxUrlRetrievalByteCount

Valore che specifica un limite al numero di byte recuperati. Il valore zero o minore non specifica alcun limite.

pPreFetchInfo

Puntatore a una struttura CRYPTNET_URL_CACHE_PRE_FETCH_INFO . Per ottenere informazioni di prelettura, impostarne cbSize all'input. Per nessuna informazione di prelettura, ad eccezione di cbSize, la struttura dei dati contiene zero al momento della restituzione.

pFlushInfo

Puntatore a una struttura CRYPTNET_URL_CACHE_FLUSH_INFO . Per ottenere informazioni di scaricamento, impostarne cbSize all'input. Per nessuna informazione di scaricamento, ad eccezione di cbSize, la struttura dei dati contiene zero al momento della restituzione.

ppResponseInfo

Puntatore a una struttura PCRYPTNET_URL_CACHE_RESPONSE_INFO . Per ottenere informazioni sulla risposta, impostare il puntatore sull'indirizzo di un puntatore CRYPTNET_URL_CACHE_RESPONSE_INFO aggiornato con la struttura allocata. Per nessuna informazione sulla risposta, ppResponseInfo è impostato su NULL. Se non è NULL, è necessario liberarlo usando la funzione CryptMemFree .

pwszCacheFileNamePrefix

Puntatore a una stringa contenente un prefisso per un nome file memorizzato nella cache. Se non è NULL, la stringa di prefisso specificata viene concatenata all'inizio del nome file memorizzato nella cache.

pftCacheResync

Puntatore a una struttura FILETIME che specifica un'ora di sincronizzazione della cache. Se non è NULL, tutte le informazioni memorizzate nella cache prima di questa ora sono considerate non valide per il tempo. Per un CRYPT_CACHE_ONLY_RETRIEVAL, se è presente una voce memorizzata nella cache prima di questa volta, CryptRetrieveObjectByUrl restituisce ERROR_INVALID_TIME. Se usato con un recupero HTTP, specifica la validità massima per un oggetto valido per il tempo.

fProxyCacheRetrieval

Valore che indica se CryptRetrieveObjectByUrl è stato chiamato con CRYPT_PROXY_CACHE_RETRIEVAL impostato in dwRetrievalFlags e una cache proxy non è stata ignorata in modo esplicito per il recupero. Questo flag non viene cancellato in modo esplicito e si applica solo ai recupero url HTTP.

dwHttpStatusCode

Valore che specifica un codice di stato da un'intestazione di risposta HTTP non riuscita. Se CRYPT_NOT_MODIFIED_RETRIEVAL è stato impostato in dwRetrievalFlags e il recupero HTTP restituisce HTTP_STATUS_NOT_MODIFIED, contiene il codice di stato HTTP_STATUS_NOT_MODIFIED . Questo valore non viene cancellato in modo esplicito e viene aggiornato solo per il recupero di URL HTTP o HTTPS.

ppwszErrorResponseHeaders

ppErrorContentBlob

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	wincrypt.h