estrutura CRYPT_RETRIEVE_AUX_INFO (wincrypt.h)

A estrutura CRYPT_RETRIEVE_AUX_INFO contém informações opcionais para passar para a função CryptRetrieveObjectByUrl . Todos os membros não utilizados dessa estrutura devem conter zero.

Sintaxe

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;

Membros

cbSize

Especifica o tamanho, em bytes, da estrutura.

pLastSyncTime

Uma estrutura FILETIME que contém a hora da última sincronização dos dados recuperados.

dwMaxUrlRetrievalByteCount

Um valor que especifica um limite para o número de bytes recuperados. Um valor igual a zero ou menor não especifica nenhum limite.

pPreFetchInfo

Um ponteiro para uma estrutura de CRYPTNET_URL_CACHE_PRE_FETCH_INFO . Para obter informações de pré-busca, defina seu cbSize após a entrada. Para nenhuma informação de pré-busca, exceto cbSize, a estrutura de dados contém zero após o retorno.

pFlushInfo

Um ponteiro para uma estrutura CRYPTNET_URL_CACHE_FLUSH_INFO . Para obter informações de liberação, defina seu cbSize após a entrada. Para nenhuma informação de liberação, exceto cbSize, a estrutura de dados contém zero após o retorno.

ppResponseInfo

Um ponteiro para uma estrutura PCRYPTNET_URL_CACHE_RESPONSE_INFO . Para obter informações de resposta, defina o ponteiro para o endereço de um ponteiro CRYPTNET_URL_CACHE_RESPONSE_INFO atualizado com a estrutura alocada. Para nenhuma informação de resposta, ppResponseInfo é definido como NULL. Se não for NULL, ele deverá ser liberado usando a função CryptMemFree .

pwszCacheFileNamePrefix

Um ponteiro para uma cadeia de caracteres que contém um prefixo para um nome de arquivo armazenado em cache. Se não for NULL, a cadeia de caracteres de prefixo especificada será concatenada na frente do nome do arquivo armazenado em cache.

pftCacheResync

Um ponteiro para uma estrutura FILETIME que especifica um tempo de sincronização de cache. Se não for NULL, todas as informações armazenadas em cache antes dessa hora serão consideradas inválidas. Para um CRYPT_CACHE_ONLY_RETRIEVAL, se houver uma entrada armazenada em cache antes dessa vez, CryptRetrieveObjectByUrl retornará ERROR_INVALID_TIME. Quando usado com uma recuperação HTTP, isso especifica a idade máxima para um objeto válido por tempo.

fProxyCacheRetrieval

Um valor que indica se CryptRetrieveObjectByUrl foi chamado com CRYPT_PROXY_CACHE_RETRIEVAL definido em dwRetrievalFlags e um cache proxy não foi explicitamente ignorado para a recuperação. Esse sinalizador não é explicitamente limpo e se aplica apenas às recuperações de URL HTTP.

dwHttpStatusCode

Um valor que especifica um código status de um cabeçalho de resposta HTTP malsucedido. Se CRYPT_NOT_MODIFIED_RETRIEVAL tiver sido definido em dwRetrievalFlags e a recuperação http retornar HTTP_STATUS_NOT_MODIFIED, isso conterá o código status HTTP_STATUS_NOT_MODIFIED. Esse valor não é explicitamente limpo e só é atualizado para recuperações de URL HTTP ou HTTPS.

ppwszErrorResponseHeaders

ppErrorContentBlob

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	wincrypt.h