structure CRYPT_RETRIEVE_AUX_INFO (wincrypt.h)

La structure CRYPT_RETRIEVE_AUX_INFO contient des informations facultatives à passer à la fonction CryptRetrieveObjectByUrl . Tous les membres inutilisés de cette structure doivent contenir zéro.

Syntaxe

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;

Membres

cbSize

Taille de la structure en octets.

pLastSyncTime

Structure FILETIME qui contient l’heure de la dernière synchronisation des données récupérées.

dwMaxUrlRetrievalByteCount

Valeur qui spécifie une limite au nombre d’octets récupérés. Une valeur égale ou inférieure à zéro ne spécifie aucune limite.

pPreFetchInfo

Pointeur vers une structure CRYPTNET_URL_CACHE_PRE_FETCH_INFO . Pour obtenir des informations de préfetch, définissez son cbSize lors de l’entrée. Pour aucune information de prérécupération, à l’exception de cbSize, la structure de données contient zéro au retour.

pFlushInfo

Pointeur vers une structure CRYPTNET_URL_CACHE_FLUSH_INFO . Pour obtenir des informations de vidage, définissez son cbSize lors de l’entrée. Pour aucune information de vidage, à l’exception de cbSize, la structure de données contient zéro au retour.

ppResponseInfo

Pointeur vers une structure PCRYPTNET_URL_CACHE_RESPONSE_INFO . Pour obtenir des informations de réponse, définissez le pointeur vers l’adresse d’un pointeur CRYPTNET_URL_CACHE_RESPONSE_INFO mis à jour avec la structure allouée. Pour aucune information de réponse, ppResponseInfo a la valeur NULL. S’il n’est pas NULL, il doit être libéré à l’aide de la fonction CryptMemFree .

pwszCacheFileNamePrefix

Pointeur vers une chaîne qui contient un préfixe pour un nom de fichier mis en cache. Si elle n’est pas NULL, la chaîne de préfixe spécifiée est concaténée à l’avant du nom de fichier mis en cache.

pftCacheResync

Pointeur vers une structure FILETIME qui spécifie une heure de synchronisation du cache. Si ce n’est pas NULL, toutes les informations mises en cache avant cette heure sont considérées comme non valides. Pour une CRYPT_CACHE_ONLY_RETRIEVAL, s’il existe une entrée mise en cache avant cette date, CryptRetrieveObjectByUrl retourne ERROR_INVALID_TIME. Lorsqu’il est utilisé avec une récupération HTTP, cela spécifie l’âge maximal d’un objet de durée de validité.

fProxyCacheRetrieval

Valeur qui indique si CryptRetrieveObjectByUrl a été appelé avec CRYPT_PROXY_CACHE_RETRIEVAL défini dans dwRetrievalFlags et si un cache proxy n’a pas été explicitement contourné pour la récupération. Cet indicateur n’est pas explicitement effacé et s’applique uniquement aux récupérations d’URL HTTP.

dwHttpStatusCode

Valeur qui spécifie un code status à partir d’un en-tête de réponse HTTP ayant échoué. Si CRYPT_NOT_MODIFIED_RETRIEVAL a été défini dans dwRetrievalFlags et que la récupération HTTP retourne HTTP_STATUS_NOT_MODIFIED, cela contient le code HTTP_STATUS_NOT_MODIFIED status. Cette valeur n’est pas explicitement effacée et n’est mise à jour que pour les extractions d’URL HTTP ou HTTPS.

ppwszErrorResponseHeaders

ppErrorContentBlob

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	wincrypt.h