estructura CRYPT_RETRIEVE_AUX_INFO (wincrypt.h)

La estructura CRYPT_RETRIEVE_AUX_INFO contiene información opcional para pasar a la función CryptRetrieveObjectByUrl . Todos los miembros sin usar de esta estructura deben contener cero.

Sintaxis

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;

Miembros

cbSize

Tamaño, en bytes, de la estructura.

pLastSyncTime

Estructura FILETIME que contiene la hora de la última sincronización de los datos recuperados.

dwMaxUrlRetrievalByteCount

Valor que especifica un límite para el número de bytes recuperados. Un valor de cero o menor no especifica ningún límite.

pPreFetchInfo

Puntero a una estructura CRYPTNET_URL_CACHE_PRE_FETCH_INFO . Para obtener información de captura previa, establezca su cbSize tras la entrada. Para ninguna información de captura previa, excepto cbSize, la estructura de datos contiene cero al devolverse.

pFlushInfo

Puntero a una estructura de CRYPTNET_URL_CACHE_FLUSH_INFO . Para obtener información de vaciado, establezca su cbSize tras la entrada. Para ninguna información de vaciado, excepto cbSize, la estructura de datos contiene cero al devolverse.

ppResponseInfo

Puntero a una estructura de PCRYPTNET_URL_CACHE_RESPONSE_INFO . Para obtener información de respuesta, establezca el puntero en la dirección de un puntero CRYPTNET_URL_CACHE_RESPONSE_INFO actualizado con la estructura asignada. Para ninguna información de respuesta, ppResponseInfo se establece en NULL. Si no es NULL, debe liberarse mediante la función CryptMemFree .

pwszCacheFileNamePrefix

Puntero a una cadena que contiene un prefijo para un nombre de archivo almacenado en caché. Si no es NULL, la cadena de prefijo especificada se concatena al principio del nombre de archivo almacenado en caché.

pftCacheResync

Puntero a una estructura FILETIME que especifica un tiempo de sincronización de caché. Si no es NULL, cualquier información almacenada en caché antes de este tiempo se considera que la hora no es válida. Para una CRYPT_CACHE_ONLY_RETRIEVAL, si hay una entrada almacenada en caché antes de esta vez, CryptRetrieveObjectByUrl devuelve ERROR_INVALID_TIME. Cuando se usa con una recuperación HTTP, especifica la antigüedad máxima de un objeto válido para el tiempo.

fProxyCacheRetrieval

Valor que indica si se llamó a CryptRetrieveObjectByUrl con CRYPT_PROXY_CACHE_RETRIEVAL establecido en dwRetrievalFlags y no se omite explícitamente una memoria caché de proxy para la recuperación. Esta marca no está desactivada explícitamente y solo se aplica a las recuperaciones de direcciones URL HTTP.

dwHttpStatusCode

Valor que especifica un código de estado de un encabezado de respuesta HTTP incorrecto. Si CRYPT_NOT_MODIFIED_RETRIEVAL se estableció en dwRetrievalFlags y la recuperación HTTP devuelve HTTP_STATUS_NOT_MODIFIED, contiene el código de estado HTTP_STATUS_NOT_MODIFIED . Este valor no se borra explícitamente y solo se actualiza para las recuperaciones de direcciones URL HTTP o HTTPS.

ppwszErrorResponseHeaders

ppErrorContentBlob

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	wincrypt.h